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Preface 


Document Structure 

This book describes how to use the VAX DOCUMENT global tags. 

Global tags are SDML tags that you can use in any doctype, with a 
few exceptions. VAX DOCUMENT Using Doctypes and Related Tags 
describes the rest of the VAX DOCUMENT tags: the doctype-specific 
tags. Doctype-specific tags are tags restricted for use in certain doctypes. 

For example, the <LIST> tag is a global tag that you can use in any doctype. 
The <SALUTATI0N> tag, however, is a doctype-specific tag that you can use 
only in the LETTER doctype. 

• Chapter 1 provides a description of all global tags. 

• Appendix A is a summary of the VAX DOCUMENT commands. 

• Appendix B lists and explains the messages you see when processing 
source files. 


Intended Audience 

This book is intended for writers, editors, and general users who wish to 
produce technical manuals, brochures, business letters, overhead slides, 
or online documentation using VAX DOCUMENT. Familiarity with a text 
editor is presumed, as is a basic knowledge of the VMS operating system. 

Associated Documents 

This manual is part of the VAX DOCUMENT documentation set that 
includes the following books: 

• VAX DOCUMENT Producing Online and Printed Documentation 

• VAX DOCUMENT Using Doctypes and Related Tags 

• VAX DOCUMENT Designing Doctypes 

• VAX DOCUMENT Tags Quick Reference 

• VAX DOCUMENT Quick Reference Card 

• VAX DOCUMENT Graphics Editor User’s Guide 

• VAX DOCUMENT Installation Guide 


Conventions 

Chapter 1 contains, in a fixed order, a discussion of each global tag. 
First, the name of the tag is followed by a brief overview that describes 
the purpose of the tag. Following the overview is a syntax section that 
displays the S5nitax of the tag: any required or optional arguments. 
Following the syntax section is an arguments section that describes any 


vii 







Preface 


arguments, any related tags, any restrictions on the use of the tag, and 
any required terminating tags. 

Note: The related tags, restrictions, and required terminator sections 
are omitted if there is no relevant information. 

The category of “related tag” is defined broadly. A tag is related to the tag 
under discussion if one of the following criteria is met: 

• It is required for use of the tag under discussion. 

• It marks a text element of the same kind as the tag under discussion. 

• It is commonly used with the tag under discussion. 

• It is a tag with a similar function to the tag under discussion. 

Next is a description section. The description expands the overview and 
presents more detailed information on using the tag. 

The discussion of a tag concludes with an examples section, with at least 
one example or a reference to an example. The example shows how to code 
the tag in an SDML file, and, when possible, shows what the formatted 
result is when the file is processed for printing. 

Each output example is introduced by a form of the sentence, “This 
example produces the following output:”. The examples were processed 
using a local doctype based on one of the six SOFTWARE doctypes, 
SOFTWARE.REFERENCE. Your output of these examples may vary, 
however, depending on the doctype you use and on whether any 
doctype modifications have been made to your local installation of VAX 
DOCUMENT. 

Table 1 lists the typographical conventions used in this manual. 


Table 1 Conventions Used in this Manual 


Convention 

Meaning 


In examples, a vertical ellipsis represents the omission of 
data that the system displays in response to a command 
or to data you enter. 


In examples, a horizontal ellipsis indicates that you can 
enter additional parameters, values, or other information. 

In tag syntax, a horizontal ellipsis indicates that arguments 
to the tag have been omitted. 

TERM 

A term that appears in bold type is defined in the glossary 
in the VAX DOCUMENT Producing Online and Printed 
Documentation. 

<TAG>(argument) 

Parentheses enclose an argument to a tag. A lowercase 
word as an argument to a tag indicates that a user- 
specified argument must be entered. 

<TAG>[(argument)] 

Brackets indicate that the enclosed argument to the tag is 
optional. 
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Table 1 (Cont.) Conventions Used in this Manual 

Convention Meaning 


<TAG>[(argument-1 [ \argument-2])] 

<TAG>[([argument-1] \ [argument-2])] 

tap r/ f argument-1 1 

< I KEYWORD-1 [\KEYWORD-2] 

<TAG>(KEYWORD) 

<TAG>(\KEYWORD) 

\ 


This tag syntax indicates that both arguments are optional. 
Only if you use argument-1, however, do you have the 
choice of using argument-2. 

This tag syntax indicates that both arguments are optional. 
You can use either argument as the first argument. 

This tag syntax indicates that all arguments are optional. 
The braces indicate a choice between argument-1 and 
KEYWORD-1. You must choose your first argument. If 
you choose KEYWORD-1, you also have the option of 
indicating KEYWORD-2 as the second argument. 

An uppercase word within an argument to a tag indicates 
that the word is a keyword, and that you must enter the 
specific keyword. 

A keyword following a backslash in an argument to a tag 
indicates that that keyword must follow a backslash. 

A backslash separates multiple arguments to a tag. 
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New Features 


The following list contains the new features of VAX DOCUMENT 

Version 2.0: 

• The considerations for Bookreader output, if different from printed 
output, are noted for each affected tag. 

• The <IjANGUAGE> tag is a new tag for creating documentation in 
several languages. 

• A new argument exists for the /DEVICE_CONVERTER qualifier on 
the DOCUMENT command line: /DEVICE_CONVERTER=DUPLEX. 
This argument creates a two-sided POSTSCRIPT document for printing 
on a duplex printer or for copying on a two-sided copier. 

• Monospaced fonts defined for all the sizes are provided for text fonts in 
the PostScript destination. 

• The new attributes, BOTH and NOMASTER, exist for indexing with 
the <X> tag. BOTH specifies an index entry that you want to appear 
in both a single-document and master index. NOMASTER specifies an 
index entry that you want to appear only in a single-document index 
and not in a master index. 

• You can refer to headings in your preface from other parts of your 
document. The headings in a preface, however, do not have numbers 
and do not appear in the table of contents. 

The documentation set has been extensively revised. A list of the major 

changes in this manual follows: 

• An improved index. 

• More and improved examples for each tag. 

• A clearer description of each tag. 

• A glossary of terms exists in VAX DOCUMENT Producing Online and 
Printed Documentation. 

• The first eight chapters of the VAX DOCUMENT User Manual, 

Volume 1, Version 1.1 is now condensed and part VAX DOCUMENT 
Producing Online and Printed Documentation. 
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Global Tag Descriptions 


This chapter provides descriptions of all global tags. The tags are listed 
alphabetically. Terminating tags, which are tags that you must use to 
terminate a tag (such as <LIST> and its terminating tag <ENDLIST>), are not 
listed separately, except when the terminating tag has an argument. Each 
terminating tag is listed in the description of the tag it terminates. You 
can also find terminating tags listed in the index. 
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<ABSTRACT> 


<ABSTRACT> 


Begins a summary description of a document on the title page or part page of 
the document. 

SYNTAX 

<ABSTRACT>^C/7ead/na)7 

ARGUMENTS 

heading 

Specifies a heading for the abstract. 

related tags 

• <FRONT_MATTER> 

• <PART_PAGE> 

• <TITLE_PAGE> 

restrictions 

Valid only in the context of a <TITLE_PAGE> or <PART_PAGE> tag. 

required 

terminator 

<ENDABSTRACT> 

DESCRIPTION 

The <ABSTRACT> tag begins a summary description of a document on the 
title page or part page of the document. A part page is a dividing page 
between major sections of a document. 

EXAMPLE 

See the example in the discussion of the <PART> tag. 
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<ACCENT> 


<ACCENT> 

Supplies a freestanding acute, grave, or umlaut accent mark. 

SYNTAX 

f ACUTE ) 

<ACCENT>(' grave \) 

{ UMLAUT } 

ARGUMENTS 

ACUTE 

GRAVE 

UMLAUT 

Specifies one of these keywords to indicate the type of accent mark. 

related tags 

• <MCS> 

• <PARENDCHAR> 

restrictions 

Invalid in math. 

DESCRIPTION 

The <ACCENT> tag supplies a freestanding acute, grave, or umlaut accent 
mark. This tag has no effect for Bookreader output. 

EXAMPLE 

The following example shows how to use the <ACCENT> tag. The 
<PARENDCHAR> tag in this example simply provides better spacing of 
the accent characters within the parentheses. See the <PARENDCHAR> tag 
description for more information. 


<P>Accents used in the Digital Multinational Character Set include the 
following: 

<LIST>(UNNUMBERED) 

<LE>Acute accents <PARENDCHAR>(<ACCENT>(ACUTE)) 

<LE>Grave accents <PARENDCHAR>(<ACCENT>(GRAVE)) 

<LE>Umlauts <PARENDCHAR>(<ACCENT>(UMLAUT)) 

<ENDLIST> 


This example produces the following output: 

Accents used in the DEC Multinational Character Set include the 
following: 

• Grave accents (') 

• Acute accents (') 

• Umlauts (") 
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<ALIGN AFTER> 


<ALIGN_AFTER> 

Allows you to position text in a list after the text specified in the argument. 

SYNTAX 

<ALIGN_AFTER>f?exO 

ARGUMENTS 

text 

Specifies the string of text after which you want to align the text that 
follows. 

related tags 

• <ALIGN_NUMBER> 

• <ALIGN_CHAR> 

• <LINE>(INDENT) 

• <LIST>(STACKED) 

restrictions 

Invalid in math. 

DESCRIPTION 

The <ALIGN_AFTEll> tag allows you to position text in a list after the text 
specified in the argument. 

EXAMPLE 

The following example shows how to create a stacked list where the text is 
aligned after the string “UN.” 


<LIST>(STACKED\BRACES) 
<LE><ALIGN_AFTER>(UN)ALPHABETICAL 
<LE>UNNUMBERED 
<ENDLIST> 


This example produces the following output: 

f ALPHABETICAL \ 

1 UNNUMBERED / 
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DESCRIPTION The <ALIGN_CHAR> tag identifies a nonprinting character you want to use 

to align numeric information in text or within a column of a list or table. 
This character signifies a space, so that the tag translator replaces each 
occurrence of the character with a space. The space is the same width as 
the numeric characters in the font that is active. (All numeric characters 
of a font have a uniform width.) 
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<ALIGN CHAR> 


Items in a column are aligned on the left by default. You may want to 
display a column of numbers aligned on the right, however. If so, use the 
<ALIGN_CHAR> tag to define “#,” for example, as the alignment character. 
You make all the numeric entries an equal length by prefixing the shorter 
entries with the alignment character. Because the numeric characters are 
of uniform width, they will then align on the right. 

You can also use the alignment character to add space within the number. 
For example, you could separate the digits of a number at the thousands 
position. 


EXAMPLES The following example defines the number sign as the alignment character 

in a table. 

Q <ALIGN_CHAR>(#) 

<TABLE> 

<TABLE_SETUP>(2\16) 

<TABLE_ROW>(0#123#456#781\01234567.89) 

<TABLE_ROW>(#######35#279\#######6.0) 

<TABLE_ROW>(########4#341\####1429.857) 

<ENDTABLE> 

<ENDALIGN_CHAR> 

This example produces the following output; 

0 123 456 781 01234567.89 

35 279 6.0 

4 341 1429.857 

The following example shows the table used in the previous example 
without using the alignment character. 

g <TABLE> 

<TABLE_SETUP>(2\16) 

<TABLE_ROW>(0123456789\01234567.89) 

<TABLE_ROW>(35279\6.0) 

<TABLE_ROW>(4361\1429.857) 

<ENDTABLE> 

This example produces the following output: 

0123456789 01234567.89 

35279 6.0 

4361 1429.857 

The following example defines the number sign as the alignment character 
in a list. 

g] <ALIGN_CHAR> (#) 

<LIST>(numbered) 

<LE>(0#123#456#781) 

<LE>(#######35#279) 

<LE>(########4#341) 

<ENDLIST> 

<ENDALIGN CHAR> 


This example produces the following output: 
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<ALIGN CHAR> 


1 0 123 456 781 

2 35 279 

3 4 361 


The following example shows the list used in the previous example without 
using the alignment character. 


0 <LIST>(numbered) 
<LE>0123456781 
<LE>35279 
<LE>4341 
<ENDLIST> 


This example produces the following output: 

1 0123456781 

2 35279 

3 4341 

The following example shows how you can represent blank output 
characters in text. The <KEEP> tag ensures that the text specified in its 
argument will not be broken across lines. See the <KEEP> tag description 
for more information. 


§ <P>The sum may be padded on the left with blanks, resulting in 
<ALIGN_CHAR>(#) 

<KEEP>(<SINGLE_QUOTE>###7.56<SINGLE_QUOTE>) 

<ENDALIGN CHAR> 


This example produces the following output: 

The sum may be padded on the left with blanks, resulting in ' 7.56' 

The following example shows how you can represent delta output 
characters in text. 


^ <P>The sum may be padded on the left with delta characters, resulting in 
<ALIGN_CHAR>(#\DELTA) 

<KEEP>(<SINGLE_QUOTE>###7.56<SINGLE_QUOTE>) 

<ENDALIGN CHAR> 


This example produces the following output: 

The sum may be padded on the left with delta characters, resulting in 
'AAA7.56' 
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<ALIGN NUMBER> 


<ALIGN_NUMBER> 


Specifies a number that you want to be aligned with other numbers in the 
same column of a table. 

SYNTAX 

<ALIGN_NUMBER> (number) 

ARGUMENTS 

number 

Specifies a number, which can include commas and decimal points, that 
is to be aligned with other numbers in the same column. Fields in the 
number that are to be left blank may contain pound sign (#) characters 
representing blank numbers or semicolon (;) characters representing 
commas or decimal points. 

related tags 

• <ALIGN_AFTER> 

• <ALIGN_CHAR> 

• <TABLE_ROW> 

restrictions 

Invalid in the context of a <MATH> tag. 

DESCRIPTION 

The <ALIGN_NUMBER> tag specifies a number that you want to be aligned 
with other numbers in the same column of a table. Items in table columns 
are aligned on the left by default. To display a column of numbers aligned 
on the right or aligned around the decimal point, use the <ALIGN_NUMBER> 
tag. Use the pound sign and semicolon characters to represent fields in 
the number that are to be blank in your output. 

EXAMPLES 

The following example shows a series of numbers aligned at the decimal 
point. 


Q <table> 

<table_setup>(2\8) 

<table_row>(one\<align_number>(100, 000, 000.##)) 
<table_row> (one\<align_number> (###; ###,*240.40)) 
<table_row>(one\<align_number>(###;###;###.60) ) 
<table_row>(one\<align_number>(###;230,425)) 
<endtable> 


This example produces the following output: 






<ALiGN NUMBER> 


one 100,000,000. 

one 240.40 

one .60 

one 230,425 

The following example is visually more elaborate, although the series of 
numbers are again aligned at the decimal point. 


g <table> 

<table_setup>(3\15\10) 

<table_heads>(Item\Net Revenue\Percentage) 

<table_row> (Knives\<align_nuinber> (#; #20; 435; ##) \<align_nuniber> (%#10.44) ) 
<table_row>(Forks\<align_number>(1,432,064.23)\<align_number>(%#45.0#)) 
<table_row>(Spoons\<align_number>(#;###;245;##)\<align_number>(%###.86)) 
<endtable> 


This example produces the following output: 


Item 

Net Revenue 

Percentage 

Knives 

20,435 

% 

10.44 

Forks 

1,432,064.23 

% 

45.0 

Spoons 

245 

% 

.86 
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<AMPERSAND> 


<AMPERSAND> 

Specifies an ampersand (&) anywhere in your file. To specify an ampersand 
in an argument to a tag or in the context of the <math> tag, you must use this 
tag. 

SYNTAX 

<AMPERSAND> 

ARGUMENTS 

None. 

related tags 

• The following tags label other characters that you must tag when they 
occur in an argument to a tag: 

<BACKSLASH> 

<CPAREN>— ^required only if there is no opening parenthesis 
<OPAREN>— required only if there is no closing parenthesis 
<VBAR> 

restrictions 

You must use the <AMPERSAND> tag to specify an ampersand in an 
argument to a tag or in the context of the <MATH> tag. 

DESCRIPTION 

The <AMPERSAND> tag specifies an ampersand (&) anywhere in your file. 
Because the ampersand has a special meaning to the tag translator when 
it occurs within an argument to a tag, you must use the <AMPERSAND> tag 
to output an ampersand within an argument to a tag or in the context of 
the <MATH> tag, or it may be misinterpreted by the tag translator. Outside 
of an argument to a tag, use the ampersand keyboard character rather 
than the tag. 

EXAMPLE 

The following example shows how to use the <AMPERSAND> tag. 


<SUBHEAD1>(Continuing the Line with <AMPERSAND>\cont_ampersand) 

<P>Your BASIC statement may be formatted over two or more lines 
by terminating all lines except the last with an ampersand (&). 

This example produces the following output: 

Continuing the Line with & 

Your BASIC statement may be formatted over two or more lines by 
terminating all lines except the last wdth an ampersand (&). 
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<APPENDIX> 



DESCRIPTION The <APPENDIX> tag begins an appendix. An appendix contains 

supplementary material at the end of a book and can contain any number 
of other tags. 

DOCUMENT considers each appendix to be an online topic. See VAX 
DOCUMENT Producing Online and Printed Documentation for more 
information about online topics. 
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<APPENDIX> 


EXAMPLE The following example shows how to code an appendix. 

<APPENDIX>{<REFERENCE>(product_name) Command Summary\command_app) 


<ENDAPPENDIX> 


See Appendix A in this manual for a sample appendix. 




<BACKSLASH> 


<BACKSLASH> 

Specifies a backsiash anywhere in your file. To specify a backslash in an 
argument to a tag, you must use this tag. 

SYNTAX 

<BACKSLASH> 

ARGUMENTS 

None. 

related tags 

• The following tags label other characters that you must tag when they 
occur in an argument to a tag: 

<AMPERSAND> 

<CPAIlEN>-required only if there is no opening parenthesis 
<OPAREN>-required only if there is no closing parenthesis 
<VBAR> 

restrictions 

You must use the <BACKSLASH> tag to specify a backslash in an argument 
to a tag. 

DESCRIPTION 

The <BACKSLASH> tag specifies a backslash an3rwhere in your file. Because 
the literal backslash character is used to separate the arguments in the 
argument list to a tag, you must use the <BACKSLASH> tag to include a 
backslash as part of your argument. Outside of an argument to a tag, use 
the backslash keyboard character rather than the tag. 

EXAMPLE 

The following example shows how to use the <BACKSLASH> tag. 


<SUBHEAD1>(Using the Backslash (<BACKSLASH>)\using_backslash) 
<P>Use the backslash character (\) to separate BASIC statements 
on the same line. 


This example produces the following output: 

Using the Backslash (\) 

Use the backslash character (\) to separate BASIC statements on the 
same line. 
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<BOX> 


<BOX> 

Produces a box that surrounds a user-specified character string. 

SYNTAX 

<BOX>(label) 

ARGUMENTS 

label 

Specifies the character string to be surrounded by the box. 

restrictions 

Invalid in the context of a <math> tag. 

The character string can be as many as 15 characters long. The box format 
is not available for £ill output devices. 

DESCRIPTION 

The <BOX> tag produces a box that surrounds a user-specified character 
string. The case of the text is output as you entered it. The font, however, 
that the <BOX> tag uses distinguishes the enclosed text from the rest of the 
text. 

EXAMPLE 

The following example shows how to use the <BOX> tag. 


<P>You may need to enclose some text in a box, <BOX>(like this). 

This example produces the following output: 

You may need to enclose some text in a box, | like this | . 
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<CALLOUT> 


<CALLOUT> 

Identifies a number that is printed as a white letter in a black box or circle 
(depending on the output device) in an example. (The <callout> tag is 
identical to the <co> tag.) 

SYNTAX 

<CALLOUT>/fnu/77fcef;7 

ARGUMENTS 

number 

This is an optional argument. It specifies the number of the callout. If you 
do not specify a callout number, the callouts are numbered sequentially. 

related tags 

• <CALLOUT_REF> 

• <CALLOUTS> 

• <CO> 

• <LIST>(CALL0UT) 

restrictions 

Valid only in the context of a <CALLOUTS> tag. 

DESCRIPTION 

The <CALLOUT> tag identifies a number that is printed as a white letter in 
a black box or circle (depending on the output device) in an example. 

EXAMPLES 

See the examples in the discussion of the <CALLOUTS> tag. 






<CALLOUT REF> 


<CALLOUT_ 

.REF> 

Labels a reference in text to a callout number. 

SYNTAX 

<CALLOUT_REF> fca/Zouf number) 

ARGUMENTS 

callout number 

Specifies the number in the callout. 

related tags 

• <CALLOUT> 

• <CALLOUTS> 

• <CO> 

• The following tags label other types of references: 

<REFERENCE>(symbol name) 

<GREF>(glossary term) 

restrictions 

Invalid in the context of a <MATH> and an <EXAMPLE> tag. 

DESCRIPTION 

The <CALL0UT_REF> tag labels a reference in text to a callout number. You 
create the callout number by using the <CALLOUT> tag in an example or 
figure. 

EXAMPLE 

The following example shows how to use the <CALLOUT_REF> tag. 


<P>In <REFERENCE>(page_transitions_fig), 
callout <CALL0UT_REF>(1) 

labels the beginning of the process. Callout <CALLOUT_REF>(2) labels the 
intermediate stage. 

This example produces the following output: 

In Figure 3-3, callout O labels the beginning of the process. Callout O 
labels the intermediate stage. 
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<CALLOUTS> 


<CALLOUTS> 

Labels the beginning of a series of callouts contained in an example and 
enables the use of the <callout> and <co> tags. 

SYNTAX 

<CALl.O[nS>[([callout number] [ 1 PREFIX])} 

ARGUMENTS 

callout number 

This is an optional argument. It sets the number that begins numbering 
the callouts. If you do not specify a number, the numbering begins with 
one. 

PREFIX 

This is an optional ke3rword argument. It specifies that the callouts appear 
before the line they label, rather than at the end of the line. All callouts 
in any one example must precede the line they label or appear inside or at 
the end of the line they label. You cannot mix the location of the callouts. 

This argument, if specified, must be the second argument, for example, 
<CALLOUTS>( \ PREFIX). 

related tags 

• <CALLOUT> 

• <CALLOUT_REF> 

• <CO> 

• <list>(CALLOUT) 

restrictions 

The <CALLOUTS> and <ENDCALLOUTS> tags must surround the examples 
within which the callouts are used. 

required 

terminator 

<ENDCALLOUTS> 

DESCRIPTION 

The <CALLOUTS> tag labels the beginning of a series of callouts contained 
in an example and enables the use of the <CALLOUT> and <CO> tags. See 
the <LIST> tag description for information about how to label callouts in a 
list. 
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<CALLOUTS> 


EXAMPLES The following example shows how to use the <CALLOUTS> tag. 


Q <CALLOUTS> 

<CODE_EXAMPLE> 

DO WHILE (^EOF); <CALLOUT> 

READ FILE(INFILE) INTO(Y); 

PUT LIST(Y); <CALLOUT> 

END; 

<ENDCODE_EXAMPLE> 

<ENDCALLOUTS> 

<LIST>(CALLOUT) 

<LE>This is a <KEYWORD>(DO) statement. 

<LE>This <KEYWORD>(PUT) statement outputs the line read. 
<ENDLIST> 


This example produces the following output: 

DO WHILE (''EOF); O 

READ FILE(INFILE) INTO(Y); 

PUT LIST(Y); © 

END; 

O This is a DO statement. 

© This PUT statement outputs the line read. 

The following example shows how you can set the number from which to 
begin numbering the callout sequence and how you can cause the callouts 
to precede the line to which they belong by using the PREFIX argument. 

g <CALLOUTS>(3\PREFIX) 

<CODE_EXAMPLE> 

<CALLOUT> DO WHILE (''EOF) ; 

READ FILE(INFILE) INTO(Y); 

<CALLOUT> PUT LIST(Y); 

END; 

<ENDCODE_EXAMPLE> 

<ENDCALLOUTS> 

This example produces the following output: 

© DO WHILE (^EOF); 

READ FILE(INFILE) INTO(Y); 

O PUT LIST(Y); 

END; 

The following example shows how you can place callouts inside of lines 
and how you can use an argument to the <CALLOUT> tag to control the 
number of the callout. 

g <CALLOUTS> 

<CODE_EXAMPLE> 

DO WHILE <CALLOUT>(9) (''EOF); 

READ FILE(INFILE) INTO(Y); 

PUT <CALLOUT>(12) LIST(Y); 

END; 

<ENDCODE_EXAMPLE> 

<ENDCALLOUTS> 


This example produces the following output: 

DO WHILE © (''EOF); 

READ FILE(INFILE) INTO(Y); 
PUT © LIST(Y); 

END; 
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<CENTER LINE> 


<CENTER_ 

LINE> 

Specifies a line of text you want to center in the current text margin. 

SYNTAX 

<CENTER_UNE>r,»„{ J 

ARGUMENTS 

text 

Specifies a line of text you want to center. 

BIGSKIP 

SMALLSKIP 

These are optional keyword arguments. They specify a set amount of 
vertical space to precede the element identified as a line or block of text. 
The actual amount of space created is determined by the doctype. 

related tags 

• <CHEAD> 

• <LINE> 

• <RIGHT_LINE> 

restrictions 

Invalid in monospaced examples, in the context of a <MATH> tag, and in 
arguments to tags that provide title or heading text. 

Centered text must fit within the current text margin. If you specify text 
that is too wide, the text formatter issues a warning message, and you 
should examine your output. 

DESCRIPTION 

The <CENTER_LINE> tag specifies a line of text you want to center in the 
current margin. 
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<CENTER_LINE> 


EXAMPLE The following example shows how to use both the BIGSKIP and 

SMALLSKIP keywords. 

<P>Please include the following information: 

<CENTER_LINE>(NameXsmallskip) 

<CENTER_LINE>(AddressXbigskip) 

<CENTER_LINE>(Phone Number) 

This example produces the following output: 

Please include the following information: 

Name 


Address 
Phone Number 




<CHAPTER> 


<CHAPTER> 

Begins a chapter. 

SYNTAX 

<CHAPTER> (chapfer title [\ symbol name]) 

ARGUMENTS 

chapter title 

Specifies the name of the chapter. The doctype may also use this argument 
in the running title. 

symbol name 

This is an optional argument. It specifies the symbol name used in all 
cross-references to this chapter. The value of the symbol name is the 
number assigned to the chapter. Each chapter is sequentially numbered. 

Symbol names must not exceed 31 characters and must only contain 
alphabetic letters, numbers, or underscores. Do not begin a sjnnbol name 
with an underscore. 

related tags 

• <REFERENCE> 

• <SET_CHAPTER_NUMBER> 

restrictions 

Invalid in the context of a <front_matter> tag. 

If you include a file containing the <CHAPTER> tag in a bookbuild, including 
a bookbuild for Bookreader, you must provide a symbol name argument 
with the tag. 

DESCRIPTION 

The <CHAPTER> tag begins a chapter. When printed, the chapter title 
and number are printed in a larger font. DOCUMENT automatically 
increments chapter numbers. 

DOCUMENT considers each chapter to be an online topic. See VAX 
DOCUMENT Producing Online and Printed Documentation for more 
information about online topics. 

EXAMPLE 

The following example shows how to code a chapter. 


<CHAPTER>(Global Tag Descriptions\tags_chap) 

<P>This chapter includes descriptions of all global tags. The tags are 
listed alphabetically. 

See the beginning of this chapter for a sample chapter. 
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<CHEAD> 


<CHEAD> 

Specifies an unnumbered centered heading. 

SYNTAX 

<CHEAD>('/7ead/ng text[\ symbol name]) 

ARGUMENTS 

heading text 

Specifies the text of the heading. 

symbol name 

This is an optional argument. It specifies the name of the symbol 
used in all references to this heading. Symbol names must not exceed 

31 characters and must only contain alphabetic letters, numbers, or 
underscores. Do not begin a symbol name with an underscore. 

related tags 

• <CENTER_LINE> 

• <HEAD> 

• <HEADn> 

• <SUBHEADn> 

DESCRIPTION 

The <CHEAD> tag specifies an unnumbered centered heading. The heading 
does not appear in the table of contents. Use the <CHEAD> tag when the 
clarity of your document requires such a fine level of distinction. 

EXAMPLE 

The following example shows how to use the <CHEAD> tag. 


<CHEAD>(How to Use the <TAG>(chead) Tag\use_of_chead) 

<P>The use of centered headings should be restricted to occasions when the 
clarity of your document absolutely requires one. 

This example produces the following output: 

How to Use the <chead> Tag 

The use of centered headings should be restricted to occasions when the 
clarity of your document absolutely requires one. 
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<CHECK FOR INCLUSiON> 


<CHECK_FORJNCLUSION> 

Marks a definitions file to ensure that the file is read only once. 

SYNTAX 

<CHECK_FORJNCLUSION>('///e/abe/j 

ARGUMENTS 

file label 

Specifies a string that uniquely identifies this file. This string is not the 
name of the file; rather, it sets an internal switch to indicate that the 
following input should be read only once. The string can contain up to 

15 alph^umeric characters or underscores and must not begin with an 
underscore. 

restrictions 

You must put the <CHECK_FOR_lNCLUSION> tag at the top of the definitions 
file and the <ENDCHECK_FOR_lNCLUSlON> tag at the bottom of the file. 

required 

terminator 

<ENDCHECK_FOR_INCLUSION> 

DESCRIPTION 

The <CHECK_FOR_lNCLUSlON> tag marks a definitions file to ensure that 
the file is read only once, because to force the tag translator to process the 
definitions twice would be a waste of processing time. The tag is useful: 

• For excluding the definitions file from being read when processing an 
individual element of a book, because the file has already been read for 
an entire bookbuild 

• For excluding the definitions file from being read during a bookbuild if 
the source files already contain the same definitions 


EXAMPLE The following example shows how you can use the <CHECK_F0R_INCLUSI0N> 

tag to exclude a file (in this example, the file MY_DEFINITIONS_FILE) 
from being read during a bookbuild. 


<CHECK_FOR_INCLUSION>(MY_DEFINITIONS_FILE) 

<DEFINE>(ansi_long\ANSI General Purpose Subset (BSR X3.74)) 
<DEFINE>(ansi_short\ANSI GPSubset) 


<ENDCHECK FOR INCLUSION> 







<co> 


<co> 

Identifies a number that is printed as a white letter in a black box or circle 
(depending on the output device) in an example. (The <co> tag is identical to 
the <CALLOUT> tag.) 

SYNTAX 

<CO>[(number)] 

ARGUMENTS 

number 

This is an optional argument. It specifies the number of the callout. If you 
do not specify a callout number, the callouts are numbered sequentially. 

related tags 

• <CALLOUT> 

• <CALLOUT_REF> 

• <CALLOUTS> 

• <list>(CALLOUT) 

restrictions 

Valid only in the context of a <CALLOUTS> tag. 

DESCRIPTION 

The <CO> tag identifies a number that is printed as a white letter in a 
black box or circle (depending on the output device) in an example. 

EXAMPLES 

See the examples in the discussion of the <CALLOUTS> tag. 






<CODE EXAMPLE> 


<CODE EXAMPLE> 


Begins an example of code. Code consists of words or lines of instructions 
written in a programming language or a command language. 


SYNTAX 


<CODE_EXAMPLE>f/n///7e code example) 

or 

f KEEP 

<CODE_EXAI\/IPLE>/’(' I WIDE[\ MAXIMUM] 

[ MAXIMUM 

code example text 


)] 


<ENDCODE EXAMPLE> 


ARGUMENTS inline code example 

Specifies code you want to insert into your text. 

If you do not use this argument, you must use the terminating tag 
<ENDCODE_EXAMPLE>. 

KEEP 

This is an optional keyword argument. It specifies that the example is 
not to be broken across pages; that is, if the example does not fit on the 
current page, it is placed on the next page. If the example itself does not 
fit on an entire single page of output, it is broken anyway. This keyword 
has no effect for Bookreader output. 

WIDE 

This is an optional ke 5 rword argument. It specifies that the width of the 
example exceeds the document’s default width for text. Depending on the 
doctype, this argument is interpreted as follows: 

• If the doctype contains a left margin area that is normally used for 
headings, the example’s width spans that area as well as the normal 
text area. 

• If the document uses a multicolumn format, the example suspends the 
multicolumn output while the example is processed. The example is 
output across two columns and then multicolumn output is restored. 

You must encase the code example in <EXAMPLE>, <FIGUIIE>, or <TABLE> 
tags in order to print the code example across two columns. 

• Depending on the doctype, this argument provides a range of font sizes 
and font styles for examples. 
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<CODE EXAMPLE> 


related tags 


restrictions 


required 

terminator 


DESCRIPTION 


MAXIMUM 

This is an optional ke 3 rword argument. It specifies that the text of the 
code example is adjusted to a smaller point size in order to fit within the 
boundaries of the left and right margins of the page. You can use this 
keyword in conjunction with WIDE to indicate that the example may 
require additional adjustment to fit within the boundaries of the page. You 
should use this keyword with discretion, and it may not be suitable in all 
doctypes. 


• <INTERACTrVE> 

• <valid_break> 


Invalid in the context of a <FOOTNOTE> tag. 

You cannot use indexing tags (<X> and <Y> tags) in code examples. 

You cannot use tab characters to format code examples. You must use 
spaces. 

You cannot use text element tags within a code example (for example, <P>, 
<LIST>, or <NOTE> tags). 

If you use double hyphens within the <CODE_EXAMPLE>(code) tag, the double 
hyphens are converted to a single en dash. This does not occur if you use 
double hyphens in the context of the <CODE_EXAMPLE> and <ENDCODE_ 
EXAMPLE> tags. 


<ENDCODE_EXAMPLE> — ^Required if you do not provide the inline code 
example argument to the <CODE_EXAMPLE> tag. 


The <CODE_EXAMPLE> tag begins an example of code. Code consists of 
words or lines of instructions written in a programming language or a 
command language. The code that is begun with a <CODE_EXAMPLE> tag 
is distinguished typographically in the output. The size of the example, 
whether it will be indented and how much it will be indented from the 
current left margin of text, is controlled by the doctype. 

Using the <CODE_EXAMPLE> tag makes the code example an informal 
example, in that the code example has no number or caption, cannot 
be referenced, and is not listed in the table of contents. If you enclose 
the code example within <EXAMPLE> and <ENDEXAMPLE> tags, however, 
the code example becomes a formal example; it then has a number and 
caption, can be referenced, and is listed in the table of contents. 

By default, informal code examples do not pop up when viewed with 
Bookreader; formal code examples do. If you want an informal code 
example to pop up, use the <ONLlNE_POPUP> tag. 

There are two types of code examples. The first is a short fragment that 
you may want included with the surrounding text. In this case, enter 
the code as an argument to the <CODE_EXAMPLE> tag and do not use a 
terminating tag. 
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<CODE EXAMPLE> 


The second type of code example is one or more lines that you may 
want broken out of the text that surrounds it. In this case, enter the 
code between the <CODE_example> and <ENDC0DE_EXAMPLE> tags. The 
character spaces and blank lines you enter to format the code are retained. 
You can also use the <ELLIPSIS> tag to achieve a vertical ellipsis showing 
that you have omitted some lines of code. If your code example is longer 
than a few lines, use the <VALID_BREAK> tag to indicate the acceptable 
points for a page break. 


EXAMPLES The following example shows a short code example that is run in with 

the surrounding text. The <VARIABLE> tag simply distinguishes a variable 
typographically. See the <VARIABLE> tag description for more information. 

Q <P>The <CODE_EXAMPLE>(WHILE INLOOP) statement causes the 

following block to be repeated until the <VARIABLE>(INLOOP) variable 
is set to FALSE. 

This example produces the following output: 

The WHILE INLOOP statement causes the following block to be repeated 
until the INLOOP variable is set to FALSE. 

The following example shows how to use the <CODE_EXAMPLE> tag with a 
longer example that is broken out of the surrounding text. In this case, 
you need the <ENDGODE_example> tag, because the code is not used as an 
argument to the <CODE_EXAMPLE> tag. 

§ <P>The call frame is built on the stack by the following four instructions: 

<CODE_EXAMPLE> 

PUSHAB B'^SKVEXIT 

PUSHL FP 

PUSHL AP 

CLRQ -(SP) 

<ENDCODE EXAMPLE> 


This example produces the following output: 

The call frame is built on the stack by the following four instructions: 

PUSHAB B^'SKVEXIT 

PUSHL FP 

PUSHL AP 

CLRQ -(SP) 

The following example shows a longer code example that uses the 
<ELLIPSIS> tag. 

§ <P>The instruction sequence listed here (patterned after code in 
module PROCSTRT) shows this second technique. 

<CODE_EXAMPLE> 

PUSHL executive-mode-PSL 
BSBB DOREI 

<ELLIPSIS> 

PUSHL user-mode-PSL 

BSBB DOREI 

<ELLIPSIS> 

DOREI: REI 

<ENDCODE EXAMPLE> 


This example produces the following output: 
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<CODE EXAMPLE> 


The instruction sequence listed here (patterned after code in module 
PROCSTRT) shows this second technique. 


PUSHL 

BSBB 

executive-mode-PSL 

DOREI 

PUSHL 

BSBB 

user-mode-PSL 

DOREI 

DOREI: 

RE I 
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<COMMENT> 


<COMMENT> 

Marks a section of an SDML file that you do not want to appear in your 
output. Text marked by a <comment> tag is ignored by the tag translator 
during processing. 

SYNTAX 

<COMMENT>(comment text) 
or 

<COMMENT> 
comment text 

■ 


■ 

<ENDCOMMENT> 

ARGUMENTS 

comment text 

Specifies the text you do not want to appear in your output. This is a 
required argument, unless you use the <COMMENT> and <ENDCOMMENT> 
tags with comment text between the two tags. 

restrictions 

You cannot nest <COMMENT> tags. 

required 

terminator 

<ENDCOMMENT> — Required if you do not specify an argument to the 
<COMMENT> tag. 

DESCRIPTION 

The <COMMENT> tag marks a section of an SDML file that you do not want 
to appear in your output. Text marked by a <COMMENT> tag is ignored by 
the tag translator during processing. 

Comments can provide useful reminders for your own use or use by writers 
who may modify your SDML file in the future. You can also use comments 
to exclude portions of text from the output file that you want to save for 
later inclusion. The text remains in the SDML file, but does not appear in 
the output. 
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<COMMENT> 


EXAMPLE The following example shows a code example with a comment embedded 

in the code. The tag translator ignores the text between the <COMMENT> 
and <ENDCOMMENT> tags. 

<CODE_EXAMPLE> 

; SECONDARY POOL COMMAND BUFFER BLOCKS 


f 

.=0 


000000 

C.CLK: 

.BLKW 

1 

;LINK WORD 

000002 

C.CTCB: 

.BLKW 

1 

;TCB ADDRESS OF TASK TO RECEIVE.COMMAND 

000004 

C.CUCB: 

.BLKW 

1 

;UCB ADDRESS IF RESPONSIBLE TERMINAL 

000006 

C.CCT: 

.BLKW 

1 

/CHARACTER COUNT, EXCLUDING TRAILING CR 

000010 

C.CSTS: 

.BLKW 

1 

/STATUS MASK 

<COMMENT> 




000012 

C.CMCD: 



/SYSTEM MESSAGE CODE 

000012 

C.CSO: 

.BLKW 

1 

/STARTING OFFSET OF VALID COMMAND TEXT 

<ENDCOMMENT> 




000014 

C.CTR: 

.BLKW 

1 

/TERMINATING CHARACTER 

000015 

C.BLK: 

.BLKW 

1 

/SIZE OF PACKET IN SEC POOL (32 WD.) BLOCKS 

000016 

C.CTXT: 



/COMMAND TEXT, FOLLOWED BY CR 


<ENDCODE EXAMPLE> 


This example produces the following output: 


; SECONDARY POOL COMMAND BUFFER BLOCKS 


000000 

.=0 

C.CLK: 

.BLKW 

1 

/LINK WORD 



000002 

C.CTCB: 

.BLKW 

1 

/TCB ADDRESS OF TASK TO RECEIVE COMMAND 

000004 

C.CUCB: 

.BLKW 

1 

/UCB ADDRESS IF RESPONSIBLE 

TERMINAL 


000006 

C.CCT: 

.BLKW 

1 

/CHARACTER COUNT, EXCLUDING 

TRAILING 

CR 

000010 

C.CSTS: 

.BLKW 

1 

/STATUS MASK 



000014 

C.CTR: 

.BLKW 

1 

/TERMINATING CHARACTER 



000015 

C.BLK: 

.BLKW 

1 

/SIZE OF PACKET IN SEC POOL 

(32 WD.) 

BLOCKS 

000016 

C.CTXT: 



/COMMAND TEXT, FOLLOWED BY CR 
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<CONDITION> 


<CONDITION> 

Marks a section of an SDML file that is not processed unless one of the 
arguments to the tag matches the argument in the related <set_condition> 
tag or matches the condition you set with the /CONDITION qualifier on the 
DOCUMENT command line. 

SYNTAX 

<COtiD\T\Ol4>(condition name-1 [\ condition name-2] 

[\ condition name-3]) 

conditional text 

■ 

■ 

<ENDCONDITION> 

ARGUMENTS 

condition name 

Specifies up to three condition names created with the <SET_CONDITlON> 
tag. At least one condition name is required. 

related tags 

• <SET_CONDITION> 

restrictions 

You cannot nest <CONDITION> tags. 

In monospaced examples, <CONDITION> and <ENDCONDITION> tags cannot 
occupy the same line as text for the example. 

required 

terminator 

<ENDCONDITION> 

DESCRIPTION 

The <C0NDITI0N> tag marks a section of an SDML file that is not processed 
unless one of the arguments to the tag matches the argument in the 
related <SET_C0NDITI0N> tag or matches the condition you set with the 
/CONDITION qualifier on the DOCUMENT command line. 

If the two tags’ arguments are identical, the marked text is processed and 
included in the output file. If the arguments differ, the text is excluded 
from processing. 

This tag can be very useful if you must produce two or more documents 
that differ in minor ways but contain much of the same text. It is efficient 
to maintain one SDML file and identify the portions of text that are unique 
to each document. 
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<CONDITION> 


Before processing the SDML file, you can specify the condition name 
for the desired document by using the <SET_CONDITlON> tag or the 
/CONDITION qualifier on the DOCUMENT command line. When the 
tag translator processes the file, it includes all portions of text tagged with 
that condition name argument and ignores all portions of text tagged with 
any other condition name. To obtain another version of the document, 
change the condition name in the argument to the <SET_CONDITION> tag or 
change the /CONDITION qualifier and reprocess the file. 

When you supply more than one condition name argument to the 
<C0NDITI0N> tag, only one of the condition names needs to be present 
for the conditional text to be processed. 


EXAMPLES The following example shows how you could organize a file if you were 

writing about holidays in general, and Christmas, Chanukah, and 
Passover in particular. Any of three different condition states could 
be set at the top of your file with the <SET_CONDlTlON>(Christmas), <SET_ 
CONDITION>(Chanukah), or <SET_CONDITION>(Passover) tags. The example 
contains four paragraphs, with each paragraph conditionalized differently. 

If the file is processed with the <SET_CONDITlON>(Christmas) tag, the 
information on Christmas and religious holidays is processed. If the 
file is processed with the <SET_CONDlTlON>(Chanukah) tag, the information 
on Chanukah and religious holidays is processed. If the file is processed 
with the <SET_CONDlTlON>(Passover) tag, the information on Passover is 
processed. 

The function of the <SET_CONDlTION> tag can be obtained by using the 
/CONDITION qualifier on the DOCUMENT command line instead. 

See VAX DOCUMENT Producing Online and Printed Documentation 
or Appendix A for more information. 

Q <CONDITION>(Christmas) 

<P>Christmas, by convention, is celebrated on December 25th . . . 

<ENDCONDITION> 

<CONDITION>(Chanukah) 

<P>Chanukah is called the Festival of Lights . . . 

<ENDCONDITION> 

<CONDITION>(Passover) 

<P>Passover is usually celebrated . . . 

<ENDCONDITION> 

<CONDITION>(Christmas\Chanukah) 

<HEAD1>(Religious Holidays) 

<P>This paragragh contains general information about several religious 
holidays . . . 

<ENDCONDITION> 


The following example shows how you can omit one of two clauses from 
processing based on the condition name specified in the <SET_CONDITlON> 
tag. The section of text that is identified with <CONDITlON>(VMS) would be 
processed and placed in the output file, whereas the other text would be 
omitted. 
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<CONDITION> 


<SET_CONDITION>(VMS) 


When the 

<CONDITION>(VMS)VAX/VMS<ENDCONDITION> 

<CONDITION>(RSX)RSX11M/RSX11M-PLUS<ENDCONDITION> 

command language interpreter translates the logical name . . . 

This example produces the following output: 

When the VAXA7MS command language interpreter translates the logical 
name . . . 

The following example shows how you can differentiate text that is 
applicable to the two condition names (VMS and RSX) from text that 
is applicable to the condition name RSTS. By supplying both the VMS and 
RSX arguments to the first <C0NDITI0N> tag, you ensure that the text is 
included in the output if either the VMS or RSX condition name is set. 
(Other text in the same SDML file might be conditional for only one of 
these condition names.) 

<SET_CONDITION>(RSX) 

<P>When RSX . . . 


<CONDITION>(VMS\RSX) 

<P>When the operating system . . . 


<ENDCONDITION> 

<CONDITION>(RSTS) 
<P>When RSTS . . . 


<ENDCONDITION> 



<CONTENTS FILE> 


(D 

1- 

Z 

UJ 

1- 

z 

o 

o 

V 

_FILE> 


Specifies the position in a source file where a table of contents output file will 
be included; it does not produce a table of contents. 

SYNTAX 

<C0NTENTS_FILE>p7e spec)] 

ARGUMENTS 

file spec 

This is an optional argument. It specifies the name of the table of contents 
file. Use this argument if you want to include a table of contents file with 
a name other than the default file name. 


The default file name is file spec_contents.DVl_device. If you specify a file 
type, be sure that the device name matches the destination device you 
specify on the DOCUMENT command line. For example, if you specify 
file spec_contents.DVl_PB, be sure you specify PS as the destination on the 
command line. 

related tags 

• <FRONT_MATTER> 


• <PROFILE> 

restrictions 

Valid only in the context of a <FRONT_MATTER> or <PR0FILE> tag. This 
tag must occur within front matter or a profile in order for processing to 
continue. 


DESCRIPTION The <C0NTENTS_FILE> tag specifies the position in a source file where a 

table of contents output file will be included; it does not produce a table 
of contents. A contents file is produced when you specify the qualifier 
/CONTENTS on the DOCUMENT command line. 

It is recommended that you place the <C0NTENTS_FILE> tag in the front 
matter file immediately before the <PREFACE> tag. This ensures correct 
placement of the table of contents in both printed and Bookreader output. 

A contents file always receives the filetype .DVI _device, where device is 
the type of output device you specified on the DOCUMENT command 
line. To generate a table of contents from an individuEd file that 
contains a <CONTENTS_FILE> tag, specify the /CONTENTS qualifier on 
the DOCUMENT command line. 

If you specify the /CONTENTS qualifier on the DOCUMENT command 
line without using the <C0NTENTS_FILE> tag in your front matter file, a 
table of contents is generated separately from your document. For more 
information on generating a table of contents, see VAX DOCUMENT 
Producing Online and Printed Documentation. 


1-34 






<CONTENTS FILE> 


EXAMPLE 


Because a table of contents is required for a book you create for 
Bookreader, a table of contents file is generated automatically if you 
do not use a <C0NTENTS_FILE> tag or the /CONTENTS qualifier on the 
DOCUMENT command line. If you do use the <C0NTENTS_FILE> tag in a 
Bookreader bookbuild, however, the tag must not precede the <TITLE_PAGE> 
tag. 


To see the result of the <CONTENTS_FlLE> tag, refer to the table of contents 
in this manual. See the example in the <FRONT_MATTER> tag description 
for an example of placing the <C0NTENTS_FILE> tag before the <PREFACE> 
tag in the front matter of a book. 
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<COPYRIGHT DATE> 


<COPYRIGHT_DATE> 

Inserts a copyright date line dn the copyright page along with other system- 
specific copyright information. 

SYNTAX 

<COPYRIGHT_DATE>fdafe/'l owner]) 

ARGUMENTS 

date 

Specifies official printing date information for the book. 

owner 

This is an optional argument. It specifies the owner of the copyright. 

Note: 

For Bookreader output, the arguments you specify are used 
to generate the copyright notice on the title page, not on the 
copyright page. 

related tags 

• <COPYRIGHT_PAGE> 

• <FRONT_MATTER> 

restrictions 

Valid only in the context of a <COPYRlGHT_PAGE> tag, which you can use 
only within the front matter of a book. 

DESCRIPTION 

The <COPYRlGHT_DATE> tag inserts a copyright date line on the copyright 
page along with other system-specific copyright information. 

EXAMPLE 

The following example shows how to use the <COPYRIGHT_PAGE> tag to 
produce a full page of output. 


<FRONT_MATTER>(front) 

<COPYRIGHT_PAGE> 

<COPYRIGHT_DATE>(1990\Smith Publishing, Inc.) 
<ENDCOPYRIGHT_PAGE> 

<ENDFRONT MATTER> 


This example produces the following output: 

Copyright ©1990 Smith Publishing, Inc. 
All Rights Reserved. 
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<COPYRIGHT PAGE> 


<COPYRIGHT_PAGE> 

Begins a copyright page and enables copyright page tags. 

SYNTAX 

<COPYRIGHT_PAGE> 

ARGUMENTS 

None. 

related tags 

• <COPYRIGHT_DATE> 

• <FRONT_MATTER> 

• <PRINT_DATE> 

restrictions 

Valid only in the front matter of a book. 

required 

terminator 

<ENDCOPYRIGHT_PAGE> 

DESCRIPTION 

The <COPYRlGHT_PAGE> tag begins a copjrright page and enables copyright 
page tags. The following tags are enabled by the <COPYRlGHT_PAGE> tag: 

• <PRINT_DATE> 

• <COPYRIGHT_DATE> 

DOCUMENT considers a copyright page to be an online topic. See VAX 
DOCUMENT Producing Online and Printed Documentation for more 
information about online topics. 


EXAMPLE The following example shows the order in which you can use the copyright 

page tags. The output of this example is a separate copyright page 
containing the print and copyright dates in the front matter of the book. 


<FRONT_MATTER>(front) 

<COPYRIGHT_PAGE> 

<PRINT_DATE>(March 1987) 

<COPYRIGHT_DATE>(1987) 

<ENDCOPYRIGHT_PAGE> 

<ENDFRONT_MATTER> 

To see an example of all the front matter tags in their correct order, see 
the example in the <FRONT_MATTER> tag description. 
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<CP> 


<CP> 

Marks the continuation of a paragraph that is interrupted by another text 
element, such as a figure, list, or a table. 

SYNTAX 

<CP> 

ARGUMENTS 

None. 

related tags 

• <p> 

restrictions 

Invalid in the context of a <MATH> tag. 

DESCRIPTION 

The <CP> tag marks the continuation of a paragraph that is interrupted by 
another text element, such as a figure, list, or a table. The <P> and <CP> 
tags may have no visible difference in effect. In a doctype in which all 
new paragraphs begin fiush left, the formatted results achieved by a <CP> 
tag and by a <P> tag are identical. In a doctype in which paragraphs are 
indented, however, the continued paragraph may still begin fiush left. 

In some instances, the <CP> tag keeps text that follows a list or 
monospaced example from being left alone at the top of the following 
page, which more closely attaches the continued paragraph to the previous 
text element. 


EXAMPLE The following example shows how to use the <CP> tag. Assume that the 

doctype is one in which paragraphs are indented. 


<P>Each time you log in, the system automatically executes 
two types of login command procedures: 

<LIST>(UNNUMBERED) 

<LE>A system login command procedure 
<LE>Your personal login command procedure 
<ENDLIST> 

<CP>These login procedures are described in the following sections. 

This example produces the following output: 

Each time you log in, the system automatically executes two types of 
login command procedures: 

• A system login command procedure 

• Your personal login command procedure 

These login procedures are described in the following sections. 




<CPAREN> 


<CPAREN> 

Supplies a closing parenthesis anywhere in your file. You must use this tag, 
however, to specify a closing parenthesis within an argument to a tag, so that 
the closing parenthesis is not interpretecd as the closing parenthesis of the 
tag’s argument. 

SYNTAX 

<CPAREN> 

ARGUMENTS 

None. 

related tags 

• The following tags label other characters that you must tag when they 
occur in an argument to a tag: 

<AMPERSAND> 

<BACKSLASH> 

<OPAREN>-required only if there is no closing parenthesis 
<VBAR> 

DESCRIPTION 

The <CPAREN> tag supplies a closing parenthesis anywhere in your file. 

You must use this tag, however, to specify a closing parenthesis within an 
argument to a tag, so that the closing parenthesis is not interpreted as 
the closing parenthesis of the tag’s argument. This tag is only beneficial 
(in terms of keystrokes and control of the output), then, as an unmatched 
closing parenthesis in an argument to a tag. 

An unmatched parenthesis in an argument can cause errors when 
processed, because the parentheses are used to determine the beginning 
and ending of an argument list. The <CPAREN> tag inserts the closing 
parenthesis character, but it is not evaluated as a closing parenthesis. 


EXAMPLE The following example shows how to use the <CPAKEN> tag. The 

<PARENDCHAR> tag in this example simply provides better spacing of 
the right parenthesis within the parentheses. See the <PARENDCHAR> tag 
description for more information. 

<SUBHEAD1>(Using a Closing Parenthesis 

<PARENDCHAR>(<CPAREN>) in an Argument to a Tag\closing_paren) 

This example produces the following output: 

Using a Closing Parenthesis ()) in an Argument to a Tag 
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<DATE> 


<DATE> 


Produces either the current system or user-specified date and time. 


SYNTAX 


<DATE>/'f| 


FULL 
date text 



ARGUMENTS FULL 

This is an optional keyword argument. It specifies a full VMS date and 
time string in the format “dd-mmm-yyyy hh:mm:ss.hh.” If you do not 
specify an argument, only the date may be produced in the format “Month 
day, year.” (The precise format varies in different doctypes.) 

date text 

This is an optional argument. It specifies text that you provide for the 
current date. If you do not specify an argument, only the date may be 
produced in the format “Month day, year.” (The precise format varies in 
different doctypes.) 

The following table specifies for all standard doctypes the output format of 
the <DATE> tag without arguments. 



Doctype 

Fomat Description 

<DATE> Tag Output 


REPORT 

MILSPEC 

All others 

Day-Month-Year 

Day Month Year 

Month Day, Year 

6-January-1990 

6 January 1990 

January 6, 1990 





restrictions 

Invalid in the context of a <MATH> tag. 



DESCRIPTION The <DATE> tag produces either the current system or user-specified date 

and time. 

Note that even if you specify the <DATE>(FULL) tag multiple times in a 
source file, it will always produce the same value. You cannot use it, 
therefore, for timing information. 


EXAMPLES The following example shows how to use the <DATE> tag. 

Q <DATE> 

This example produces the following output: January 28,1991 
The following example shows how to use the <DATE>(FULL) tag. 
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<DATE> 


g <DATE>(FULL) 

This example produces the following output: 28-JAN-1991 11:03:30.58 
The following example shows how to use the <DATE>(date text) tag. 

§ <DATE>(February 26, 1990 A.D.) 

This example produces the following output: February 26,1990 A,D. 
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<DEFINE_BOOK_NAME> 


<DEFINE_BOOK_NAME> 

Defines the title of a book and associates a user-defined symbol name to the 
cross-reference file. 

SYNTAX 

<DEFINE_BOOK_NAME> fsymdo/ name 1 title) 

ARGUMENTS 

symbol name 

Specifies the symbol that is associated with the title of the book. Symbol 
names must not exceed 31 characters and must only include alphabetic 
letters, numbers, or underscores. Do not begin a symbol name with an 
underscore. 

title 

Specifies the exact text of the book’s title. 

related tags 

• <DEFINE_SYMBOL> 

• <DELAYED> 

• <REFERENCE> 

restrictions 

If you want to nest a tag in the title argument, you must use the 
<DELAYED> tag to surround the nested tag. This causes the nested tag 
to be preserved until it is about to be output using the <REFERENCE> tag. 

DESCRIPTION 

The <DEFlNE_BOOK_NAME> tag defines the title of a book and associates 
a user-defined symbol name to the cross-reference file. When you 
subsequently reference the title with the <REFERENCE> tag, suppl5dng 
the same symbol name as an argument to the <reference> tag, the 
book title is retrieved from the cross-reference file and is substituted for 
the reference. Depending on the doctype, the title may be output with 
emphasized text (for example, italicized text). 

Note that the symbol name argument is the first argument to the tag. In 
text element tags, the symbol name is always the second argument. Only 
the <DEFlNE_BOOK_NAME> and <DEFINE_SYMBOL> tags take a symbol name 
as a first argument. Placing the symbol name as the first argument to 
these tags makes it easy to keep track of your symbol names when you list 
them in a local definitions file, where they are aligned and easy to find. 
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<DEFiNE BOOK NAME> 


EXAMPLE The following example shows how to use the <DEFlNE_BOOK_NAME> tag 

for defining the S 5 mibol name of the book, Book of Games, Volume 2, as 
games Jbook. 

<DEFINE_BOOK_NAME>(games_book\Book of Games, Volume 2) 

You can use the <REFERENCE>(games_book) tag anywhere in the document to 
refer to the book by name. For example, you might say the following: 

<P>The authors suggest that you read the <REFERENCE>(games_book) 
before you try any of the more complex games. 

This example produces the following output: 

The authors suggest that you read the Book of Games, Volume 2 before you 
try any of the more complex games. 
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<DEFINE SYMBOL> 


<DEFINE_ 

_SYMBOL> 

Associates a string of text with a user-defined symbol, so that you can 
reference the text by this symbol throughout the document. 

SYNTAX 

<DEFINE_SYMBOL>fsym£)o/name 1 text string) 

ARGUMENTS symbol name 

Specifies the name assigned to the symbol. Symbol names must not 
exceed 31 characters and must only include alphabetic letters, numbers, or 
underscores. Do not begin a symbol name with an underscore. 

text string 

Specifies the text to be referenced by the symbol name. Throughout the 
document, you can specify the symbol name in the <REFERENCE> tag, and 
this text string is then substituted for the symbol name during processing. 

related tags 

• <DEFINE_BOOK_NAME> 

• <DELAYED> 

• <REFERENCE> 

restrictions 

If you want to nest a tag in the text string argument, you must use the 
<DELAYED> tag to surround the nested tag. This causes the nested tag to 
be preserved until it is about to be output using the <REFERENCE> tag. 


DESCRIPTION The <DEFlNE_SYMBOL> tag associates a string of text with a user-defined 

symbol, so that you can reference the text by this symbol throughout the 
document. It adds the symbol name and the text to the symbol table. 
When you subsequently reference this text by using the <REFERENCE> tag 
and by specif 3 dng the same symbol name as its argument, the current 
value of the symbol name is retrieved from the table and the text is 
substituted for the reference. 

For more information on the use of the symbol table, see VAX 
DOCUMENT Producing Online and Printed Documentation. 

Note; The symbol name argument to the <define_SYMBOL> tag must be 
on the same line as the tag; spaces and carriage returns are 
significant and are interpreted as part of the symbol name. 

Note that the symbol name argument is the first argument to the tag. In 
text element tags, the symbol name is always the second argument. Only 
the <define_BOOK_NAME> and <define_SYMBOL> tags take a symbol name 
as a first argument. Placing the symbol name as the first argument to 
these tags makes it easy to keep track of your symbol names when you list 
them in a local definitions file, where they are aligned and easy to find. 
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<DEFINE SYMBOL> 


EXAMPLES The following example shows how you can define the phrase, “RTL routine 

Set Logical Name, LIB$SET„LOGICAL,” as the symbol name, “set_ 
logical,” and then refer to it in text by that symbol name. By using the 
symbol name in the places you want the phrase to occur, you can save 
keystrokes and ensure that you never have a typing error in that phrase. 

Q <define_symbol>(set_logical\RTL routine Set Logical Name, LIB$SET_LOGICAL,) 

<P>The <REFERENCE>(set_logical) requests the calling process's CLI to 
define or redefine a supervisor-mode logical name. 

This example produces the following output: 

The RTL routine Set Logical Name, LIB$SET_LOGICAL, requests the 
calling process’s CLI to define or redefine a supervisor-mode logical name. 

The following example uses the <DELAYED> tag wdthin the argument to the 
<DEFINE_SYMB0L> tag, causing the <DELAYED> tag to be evaluated by the 
tag translator after the <DEPINE_SYMB0L> tag. 

The symbol TEMP_CHART_EX is associated with the text string that is 
enclosed by the <DELAYED> and <ENDDELAYED> tags. None of the enclosed 
tags will have been evaluated. 

§ <define_syrribol> (temp_chart_ex\<delayed> 

<example>(Temperature Chart) 

<code_example> 

Centigrade 0 Fahrenheit 32 

Centigrade 100 Fahrenheit 212 

<endcode_example> 

<endexample> 

<enddelayed>) 

Subsequently, you can refer to the symbol name with a <REFERENCE> tag, 
as in the following example: 

<REFERENCE>(temp_chart_ex) 

Using this reference results in the following output: 

Example n-n Temperature Chart 


Centigrade 0 Fahrenheit 32 
Centigrade 100 Fahrenheit 212 
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<DEFINITION LIST> 


<DEFINITION_LIST> 

Begins a definition iist, which includes an item followed by its definition. 

SYNTAX 

«:DEFINITION_LIST> 

ARGUMENTS 

None. 

related tags 

• <DEFINITION_LIST_HEAD> 

• <DEFLIST_DEF> 

• <DEFLIST_ITEM> 

required 

terminator 

<ENDDEFINITION_LIST> 

DESCRIPTION 

The <DEFINITI0N_LIST> tag begins a definition list, which includes an 
item, introduced by the <DEFLIST_ITEM> tag, followed by its definition, 
introduced by the <DEFLIST_DEF> tag. The definition hst differs from a 
list created with the <LIST> tag in that the definition list items are not 
numbered or called out in any way. 

You can give the definition list a heading by using the <DEFINITION_LlST_ 
HEAD> tag. Each list can contain one or more items, using the <DEFLIST_ 
ITEM> tag, and each item can have a definition, using the <DEFLIST_DEF> 
tag. 

EXAMPLE 

The following example shows how to use the <DEFINITION_LIST> tag. 


<definition_list> 

<deflist_item>(Hargreaves, James\d. 1778.) 
<deflist_def>English inventor. 

<deflist_item>(Harris, Joel Chandler\Born 1848.\Died 1908.) 
<deflist_def>American author. 

<enddefinition list> 


This example produces the following output: 

Hargreaves, James 
d. 1778. 

English inventor. 
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<DEFINITION LIST> 


Harris, Joel Chandler 
Born 1848. 

Died 1908. 

American author. 


1-47 



<DEFINITION_LIST_HEAD> 

<DEFINITION_LIST_HEAD> 

Supplies the heading for a iist of defined items you specify with the 
<DEFINITION_LIST> tag. 


SYNTAX <DEFINITI0N_LIST_HEAD>('/7eac//nsr text) 

ARGUMENTS heading text 

Specifies the text for a heading that precedes the definition list, 
related tags • <definition_list> 

• <DEFLIST_DEF> 

• <DEFLIST_ITEM> 

restrictions Valid only in the context of a <DEF1NITI0N_LIST> tag. 


DESCRIPTION The <DEFINITI0N_LIST_HEAD> tag supplies the heading for a list of defined 

items you specify with the <DEFINITI0N_LIST> tag. 


EXAMPLE The following example shows how to use the <definition_list_head> tag. 

<definition_list> 

<definition_list_head>(Worldwide Associates) 

<deflist_itein> (lAAF) 

<deflist_def> 

International Amateur Athletic Federation 
<deflist_item>(IAEA) 

<deflist_def> 

International Atomic Energy Agency 
<enddefinition list> 


This example produces the following output: 


WORLDWIDE 

ASSOCIATES 


lAAF 

International Amateur Athletic Federation 

IAEA 

International Atomic Energy Agency 
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<DEFLIST DEF> 


<DEFLIST_ 

DEF> 

Introduces an item’s definition in a definition list. 

SYNTAX 

<DEFLIST_DEF> 

ARGUMENTS 

None. 

related tags 

• <DEFINITION_UST> 

• <DEFINITION_LIST_HEAD> 

• <DEFLIST_ITEM> 

restrictions 

Valid only in the context of a <DEFINITI0N_LIST> tag. 

DESCRIPTION 

The <DEFLIST_DEF> tag introduces an item’s definition in a definition list. 
Specify the item by using the <DEFLIST_ITEM> tag and specify the definition 
list by using the <DEFINITI0N_LIST> tag. 

EXAMPLE 

See the example in the discussion of the <DEFINITI0N_LIST> tag. 
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<DEFLIST ITEM> 


<DEFLIST_ 

ITEM> 

Marks an item you want to define in a definition list. 

SYNTAX 

<DEFLIST_ITEM>('/fe/r7-r [\ item-2... [\item-7]]) 

ARGUMENTS 

Item 

Specifies the item you want to define. You can specify up to seven items. 

related tags 

• <DEFINITION_LIST> 

• <DEFINITION_LIST_HEAD> 

• <DEFLIST_DEF> 

restrictions 

Valid only in the context of a <DEFINITION_LIST> tag. 

DESCRIPTION 

The <DEFLIST_ITEM> tag marks an item you want to define in a definition 
list. A definition list contains paired entries, consisting of the item being 
defined, introduced by the <DEFLIST_ITEM> tag, and the item’s definition, 
introduced by the <DEFLIST_DEF> tag. 

EXAMPLE 

See the example in the discussion of the <definition_LIST> tag. 
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<DELAYED> 


<DELAYED> 

Allows you to specify text that contains a tag in an argument to another 
tag. Execution of the <delayed> tag is delayed until the outer tag’s text is 
processed. 

SYNTAX 

<DELAYED>fde/ayed text) 

or 

<DELAYED> 
delayed text 

■ 

■ 

<ENDDELAYED> 

ARGUMENTS 

delayed text 

Specifies the text containing tags whose execution is delayed until the text 
is output. 

related tags 

• <DEFINE_BOOK_NAME> 

• <DEFINE_SYMBOL> 

Any tag that takes a symbol name argument 

restrictions 

The <DELAYED> tag cannot be nested within itself. 

You must use this tag if you want to nest a tag in the argument of a tag 
that also takes a symbol name argument. 

required 

<ENDDELAYED> —^Required if you do not specify an argument to the 

terminator 

<DELAYED> tag. 

DESCRIPTION 

The <DELAYED> tag allows you to specify text that contains a tag in an 
argument to another tag. Execution of the <DELAYED> tag is delayed until 
the outer tag’s text is processed. 

Using a tag within an argument to another tag is called nesting a tag in 
an outer tag’s argument. Normally, the tag translator evaluates the nested 
tag first, then evaluates the outer tag. 
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<DELAYED> 


When you want the outer tag to be processed before the nested tag, you 
must use the <delayed> tag to surround the nested tag. For example, 
when the outer tag is the <DEFINE_SYMBOL>(symbol name\text string) tag, yOU 
must use the <DELAYED> tag to surround the nested tag in the text string 
argument. This causes the nested tag to be preserved until it is about to 
be output using the <REFERENCE> tag. 


EXAMPLE The following example shows how to use the <DELAYED> tag. The symbol 

TEMP_CHAKT_EX is associated with the text string that is enclosed by 
the <DELAYED> and <ENDDELAYED> tags. None of the enclosed tags will 
have been evaluated. 


<define_symbol> (teinp_chart_ex\<delayed> 
<example>(Temperature Chart) 
<code_example> 

Centigrade 0 Fahrenheit 32 

Centigrade 100 Fahrenheit 212 

<endcode_example> 

<endexample> 

<enddelayed>) 


Subsequently, you can refer to the s 5 mibol name with a <REFERENCE> tag, 
as in the following example: 

<REFERENCE>(temp_chart_ex) 

Using this reference results in the following output: 

Example n-n Temperature Chart 


Centigrade 0 
Centigrade 100 


Fahrenheit 32 
Fahrenheit 212 




<DOCTYPE> 


<DOCTYPE> 

lidentifies the ijoctype for your file. This tag is for informational purposes only. 

SYNTAX 

<DOCTYPE>(document type) 

ARGUMENTS 

document type 

Specifies the doctype you want to use for your file. 

DESCRIPTION 

The <DOGTYPE> tag identifies the doctype for your file. This tag is for 
informational purposes only; it does not designate the doctype. 


You can include this tag anywhere in your file for informational purposes. 
You do not have to include the <doctype> tag in your file in order to 
process your file, however. Instead, you must specify the doctype on the 
DOCUMENT command line, which allows you to process your file using 
different doctypes to determine which one suits your needs. 

EXAMPLE 

The following example shows how you can identify a book’s doctype as 
“REPORT”. Refer to VAX DOCUMENT Using Doctypes and Related Tags 
for sample output of the various doctypes. 


<DOCTYPE>(report) 








<DOUBLE QUOTE> 


<DOUBLE QUOTE> 


Supplies a double quotation mark as it appears when it is typeset. 


SYNTAX <DOUBLE QUOTE> 


ARGUMENTS None. 


related tags • <parendchar> 

• <QUOTE> 

• <SINGLE_QUOTE> 


DESCRIPTION The <DOUBLE_QUOTE> tag supplies a double quotation mark as it appears 

when it is typeset. This is different from the double quotation mark that 
your keyboard produces. 

Your keyboard has two possible characters you can use for quotation 
marks: the double quote, (") (ASCII 34) and the single quote (' ) (ASCII 
39). In programming languages, a quoted string usually begins and ends 
with the same character, either "a quoted string ," or ' a quoted string.' 
Using the double or single quotation marks from your keyboard is usually 
adequate for showing examples of user input or screen displays. 

If you want your output to show a double quotation mark as it is appears 
when it is typeset, however, use the <DOUBLE_QUOTE> tag. 

If you want your output to follow typesetting conventions by using distinct 
opening and closing quotation marks, use the <QUOTE> tag instead of 
double quotation marks from your keyboard. You would use the <QUOTE> 
tag, for example, in citing a passage from another book. See the <QUOTE> 
tag description for more information. 


EXAMPLES The following example shows how to use the <DOUBLE_QUOTE> tag. 

Q <P>You can cause the translation of a symbol by using a double 
quotation mark (<DOUBLE_QUOTE>) directly in front of it. 

This example produces the following output: 

You can cause the translation of a symbol by using a double quotation 
mark (") directly in front of it. 

The following example shows what your output would be like without 
using the tag, but just entering the double quotation mark character from 
the keyboard. 
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<DOUBLE QUOTE> 


<P>You can cause the translation of a symbol by using a double 
quotation mark (") directly in front of it. 

This example produces the following output: 

You can cause the translation of a symbol by using a double quotation 
mark (") directly in front of it. 
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<ELEMENT> 


<ELEMENT> 

Identifies a file that contains an element of a book. 

SYNTAX 

<ELEMENT>f/y/e spec) 

ARGUMENTS 

file spec 

Specifies a file. You must supply the file type (for example, .sdml). 

related tags 

• <INCLUDES_FILE> 

• <PROFILE> 

restrictions 

Valid only in the context of a <PROFILE> tag. 

DESCRIPTION 

The <ELEMENT> tag identifies a file that contains an element of a book. A 
profile of a book is required in order to build (process) a book. A book’s 
profile contains an ordered list of the elements that comprise the book. In 
the profile, you label each of these elements with an <ELEMENT> tag. Only 
those files listed with <ELEMENT> tags are included in the book during the 
bookbuild. List those files in the profile according to the order in which 
they appear in the book. 

A file specified as an element must begin with one of the following tags: 


• <APPENDIX> 


• <CHAPTER> 


• <FRONT_MATTER> 


• <GLOSSARY> 


• <PART> 


For more information on creating a profile and bookbuilding, see VAX 
DOCUMENT Producing Online and Printed Documentation. 


EXAMPLE Assume that a writer is writing a book that contains several chapters. 

One of the chapters is the file My_Intro_Chap.SDML. At the top of this file 
is included the <CHAPTER>(Introduction\intro_chap) tag to distinguish it 
as a chapter. 

Along with the other <ELEMENT> tags for this book, the profile would then 
contain the following: 

<ELEMENT>(My_Intro_Chap.SDML) 
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<ELEMENT> 


See the example in the <PR0FILE> tag description to see how to arrange 
the <ELEMENT> tags in a profile. 
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<ELLIPSIS> 


<ELLIPSIS> 

Supplies vertical ellipsis points to show omitted material in text and tables. 

SYNTAX 

<ELLIPSIS> 

ARGUMENTS 

None. 

related tags 

• <HELLIPSIS> 

restrictions 

Invalid in the context of a <MATH> tag. 

Place the tag alone on a line in monospaced examples, or else the first 
“dot” of the ellipsis will be misaligned. 

DESCRIPTION 

The <ELLIPSIS> tag supplies vertical ellipsis points to show omitted 
material in text and tables. The vertical ellipsis is positioned with respect 
to the current left margin. 

EXAMPLES 

The following example shows how to use the <ELLIPSIS> tag. 


Q <P>The instruction sequence listed here (patterned after code in 
module PROCSTRT) shows this second technique. 

<CODE_EXAMPLE> 

PUSHL executive-mode-PSL 
BSBB DOREI 

<ELLIPSIS> 

PUSHL user-mode-PSL 

BSBB DOREI 

<ELLIPSIS> 

DOREI: REI 

<ENDCODE EXAMPLE> 


This example produces the following output: 

The instruction sequence listed here (patterned after code in module 
PROCSTRT) shows this second technique. 


PUSHL executive-mode-PSL 

BSBB DOREI 


PUSHL user-mode-PSL 

BSBB DOREI 


DOREI: REI 


The following example shows how you can use the <ELLIPSIS> tag in a 
table. 
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<ELLIPSIS> 


<TABLE>(Rules for Determining Expression Modes\express_modes_tab) 
<TABLE_ATTRIBUTES>(MULTIPAGE) 

<TABLE_SETUP>(2\43) 

<TABLE_HEADS> (ExpressionWalue Type) 

<TABLE_ROW>(Integer value\Integer) 

<TABLE_ROW>(<ELLIPSIS>\<ELLIPSIS>) 

<TABLE_ROW>(String value\String) 

<TABLE_ROW>(Integer lexical function\Integer) 

<TABLE_ROW>(String lexical function\<ELLIPSIS>) 

<TABLE_ROW>(Integer symbol\Integer) 

<TABLE_ROW>(String symbol\String) 

<TABLE_ROW>(Any value .AND. or .OR. any value\Integer) 
<TABLE_ROW>(Any value\Integer) 

<TABLE_ROW>(Any value\Integer) 

<ENDTABLE> 


This example produces the following output: 


Table n-n Rules for Determining Expression Modes 


Expression 

Value Type 

Integer value 

Integer 


String value 

String 

Integer lexical function 

Integer 

String lexical function 



Integer symbol 

Integer 

String symbol 

String 

Any value .AND. or .OR. any value 

Integer 

Any value 

Integer 

Any value 

Integer 
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<EMPHASIS> 



EXAMPLE The following example shows how to use the <EMPHASIS> tag. 


<P>An <EMPHASIS>(overuse) of the <TAG>(EMPHASIS) tag 
<EMPHASIS>(inevitablyXbold) ALWAYS 
<EMPHASIS>(reduces\small_boldcaps) its 
<EMPHASIS>(effectivenessXsmallcaps). 

This example produces the following output: 
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<EMPHASIS> 


An overuse of the <EMPHASIS> tag inevitably ALWAYS REDUCES its 
EFFECTIVENESS. 



<ENDCOPYRIGHT PAGE> 


<ENDCOPYRIGHT_PAGE> 

Terminates the copyright page an(d optionally provitdes text that is output at the 
bottom of the copyright page. 

SYNTAX 

<EUDCOPyR\GHT_PAGE>[(identification)] 

ARGUMENTS 

identification 

This argument is optional. It specifies a local convention for information 
on the copyright page. 

related tags 

• <COPYRIGHT_PAGE> 

• <FRONT_MATTER> 

• <PRINT_DATE> 

restrictions 

Use only to terminate a <COPYRlGHT_PAGE> tag. You can only use the 
copyright page in the context of the <FRONT_MATTER> tag. 

DESCRIPTION 

The <ENDCOPYRlGHT_PAGE> tag terminates the copyright page and 
optionally provides text that is output at the bottom of the copyright 
page. 

EXAMPLE 

The following example shows the order in which to use the copyright page 
tags. The output of this example is a separate copyright page in the front 
matter of the book, and the page contains the print and copyright dates. 
The argument to the <ENDCOPYRIGHT_PAGE> tag, “ZK5352”, is a local 
identification number that appears at the bottom of the cop 5 nright page. 


<FRONT_MATTER>(front) 
<COPYRIGHT_PAGE> 
<PRINT_DATE>(November 1990) 
<COPYRIGHT_DATE>(1990) 
<ENDCOPYRIGHT_PAGE>(ZK5352) 
<ENDFRONT MATTER> 


To see an example of all the front matter tags in their correct order, see 
the example in the <FRONT_MATTER> tag description. 

See the copyright page of this manual for a sample cop 3 )Tight page. 
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<ENDPART PAGE> 


<ENDPART_ 

.PAGE> 

Terminates a part page (which is a dividing page between major sections of a 
document) and optionally specifies paging attributes for text that follows. 

SYNTAX 

<EUDPfim_PAGE>[(RENUMBER)] 

ARGUMENTS 

RENUMBER 

This is an optional keyword argument. It specifies that page numbering 
following the part page begins with 1. If you do not use this argument, 
page numbering continues following the part page with the next odd- 
numbered page. 

Using this argument has no effect on Bookreader output. 

related tags 

• <PART_PAGE> 

restrictions 

Use only to terminate a <PART_PAGE> tag. 

DESCRIPTION 

The <ENDPART_PAGE> tag terminates a part page and optionally specifies 
paging attributes for text that follows. 

EXAMPLE 

See the example in the discussion of the <PART> tag. 
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<ENDTITLE PAGE> 


1 

UJ 

1- 

1- 

o 

z 

U1 

V 

A 

LU 

CD 

s 


Terminates a title page and optionally specifies text to appear at the bottom of 
the title page. 

SYNTAX 

<ENDTITLE_PAGE>^ffexy7 

ARGUMENTS 

text 

This is an optional argument. It specifies that a line of text appear at the 
bottom of the title page. 

related tags 

• <PART_PAGE> 

restrictions 

Use only to terminate a <TITLE_PAGE> tag. 

DESCRIPTION 

The <ENDTITLE_PAGE> tag terminates a title page and optionally specifies 
text to appear at the bottom of the title page. 


EXAMPLE The following example shows how to code a title page of a short document. 

See the example in the discussion of the <FRONT_MATTER> tag for an 
example of using this tag in the front matter of a book. 


<TITLE_PAGE> 

<TITLE>(How to Code your SDML Source Files) 
<ENDTITLE_PAGE>(This is for informational purposes only.) 
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<EXAMPLE> 


<EXAMPLE> 


Labels the beginning of an example. 


SYNTAX <EXAMPLE>[(example captionf 1 symbol name])] 


ARGUMENTS example caption 

This is an optional argument. It specifies the text of the caption to be 
associated with the example. The example caption and the associated 
example number will be included in the table of contents of the document. 

symbol name 

This is an optional argument. It specifies the symbolic identifier to be 
associated with the example. The symbol name is assigned a numeric 
value, which is the current example number. The symbol and its value are 
placed in the symbol table. 

Symbol names must not exceed 31 characters and must only include 
alphabetic letters, numbers, or underscores. Do not begin a symbol name 
with an underscore. 


related tays * <code_example> 

• <EXAMPLE_ATTRIBUTES> 

• <EXAMPLE_FILE> 

• <EXAMPLE_SPACE> 

• <INTERACTIVE> 

• <REFERENCE> 

• <S> 

• <SAMPLE_TEXT> 

• <U> 

• <VALID_BREAK> 


restrictions Cannot contain any text element tags, such as <CHAPTER>, <FIGURE>, 

<MATH>, <LIST>, <P>, or <TABLE>. 

Invalid in the context of a <FOOTNOTE> tag. 

Can only contain text that you label with <CODE_EXAMPLE>, <INTERACTIVE>, 
and <SAMPLE_TEXT> tags. Use a <P> tag within the context of the <SAMPLE_ 
TEXT> tag to provide paragraph format of the sample text. 

If you use an <EXAMPLE_FILE> tag in the context of an <EXAMPLE> tag, 
that file included by the <EXAMPLE_FILE> tag must contain either a code 
example (using the <CODE_EXAMPLE> tag) or an interactive example (using 
the <INTERACTIVE> tag). 






<EXAMPLE> 


required 

terminator 


DESCRIPTION 


<ENDEXAMPLE> 


The <EXAMPLE> tag labels the beginning of a formal example or 
informal example. A formal example is an example that has a number 
and a caption, can be referenced, and is listed in the table of contents. 

An informal example does not have a number or a caption, cannot be 
referenced, and is not listed in the table of contents. Moreover, you create 
an informal example with the <CODE_EXAMPLE> tag. See the <CODE_ 
EXAMPLE> tag description for more information. 

You can create a formal example in a number of ways: 

• By including a specified file in your example by using the <example_ 
FILE> tag 

• By leaving space for an example to be pasted in during final production 
by using the <EXAMPLE_SPACE> tag 

• By using text labeled with <CODE_EXAMPLE>, <riSfTEEACTrvE>, <S>, 
<SAMPLE_TEXT>, and <U> tags 

You cannot use tables, lists, paragraphs, and other text elements in a 
formal example. You can, however, use a <P> tag within the context of a 
<SAMPLE_TEXT> tag to provide paragraph format of the sample text. See 
the <EXAMPLE_SEQUENCE> tag description in VAX DOCUMENT Using 
Doctypes and Related Tags for information about how to construct an 
example sequence that can include a variety of text elements. 

If the body of the example spans more than a single page of text, the 
example caption is repeated on each page on which the example continues. 

If the example is more than a page, page breaks are handled automatically 
by the text processor. You can control the page breaking by using <PAGE> 
tags to specify explicit page breaks, or <valid_BREAK> tags within the 
example to specify good breaking points. If you explicitly break a page by 
using the <PAGE> or <VALID_BREAE:> tags, the example caption is continued 
on the following page, as it is if the page is broken automatically by the 
text processor. 

When a floating figure or fioating example precedes a multipage table (all 
tables not marked with the KEEP ke 5 word are multipage), a succession of 
short pages may occur before the page on which the table begins. This is 
because a multipage table forces any previous floating figures or examples 
to be output before the table begins. 

If this situation occurs, code the preceding floating figures or examples 
with the KEEP keyword so that they will be kept with the text preceding 
them, resulting in better-balanced pages. 

See the description of the FLOAT kejrword argument to the <EXA]V[PLE_ 
ATTRIBUTES> tag for information about floating figures or examples. 
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<EXAMPLE> 


Note the following when processing a book for Bookreader display: 

• You must use the symbol name argument to process a formal example 
for Bookreader display. 

• DOCUMENT automatically creates pop-up windows for all formal 
examples. 

• When introducing and cross-referencing a formal example, you must 
use the <REFERENCE> tag to create a hotspot. Hotspots are regions in 
the windows you click on with your mouse to access cross-referenced 
topics. 

• You can use the <ONLINE_POPUP> tag if you want to make informal 
examples pop up. 


EXAMPLES The following example shows a one-page example that uses the WIDE 

argument of the <EXAMPLE_ATTRIBUTE> tag. The contents of the example 
are included using the <EXAMPLE_FILE> tag. The file that is included must 
contain either a code example or interactive example. 

Q <EXAMPLE> (VAXcluster Multi-file Sunimary\multi_file_exam) 

<EXAMPLE_ATTRIBUTES>(WIDE) 

<EXAMPLE_FILE> (monitor_multi_file_summary. sciinl) 

<ENDEXAMPLE> 


This example produces the following output: 

Example n-n VAXcluster Multi-file Summary 


+ - + 

VAX/VMS : 

Monitor Utility 






I AVE I 

TIME IN 

PROCESSOR MODES 






+ --H 

MULTI 

-FILE SUMMARY 






Node: 

MOE 

CURLEY 

LARRY 





From: 

15-APR-1984 18:17 

15-APR-1984 18:17 

15-APR-1984 

18:17 

Row 

Row 

Row 

To: 

15-APR-1984 20:17 

15-APR-1984 20:17 

15-APR-1984 

20:17 

Sum 

Average 

Minimum 

Interrupt Stack 

6.51 

0.50 


6.25 

13.2 

4.4 

0.50 

Kernel Mode 

25.73 

0.42 


12.43 

38.5 

12.8 

0.42 

Executive Mode 

9.46 

0.95 


1.81 

12.2 

4.0 

0.95 

Supervisor Mode 

1.97 

0.00 


0.16 

2.1 

0.7 

0.00 

User Mode 

13.24 

5.33 


56.14 

74.7 

24.9 

5.33 

Compatibility Mode 

0.00 

0.07 


0.00 

0.0 

0.0 

0.00 

Idle Time 

23.61 

0.02 


92.63 

116.2 

38.7 

0.02 

+ - + 

VAX/VMS Monitor Utility 






I AVE I 

PAGE MANAGEMENT STATISTICS 






+-+ 

MULTI- 

-FILE SUMMARY 






Node: 

MOE 

CURLEY 

LARRY 





From: 

15-APR-1984 18:17 

15-APR-1984 18:17 

15-APR-1984 

18:17 

Row 

Row 

Row 

To: 

15-APR-1984 20:17 

15-APR-1984 20:17 

15-APR-1984 

20:17 

Sum 

Average 

Minimum 

Page Fault Rate 

36.73 

8.81 


0.49 

46.0 

15.3 

0.49 

Page Read Rate 

14.28 

4.71 


0.00 

19.0 

6.3 

0.00 

Page Read I/O Rate 

1.20 

0.70 


0.00 

1.9 

0.6 

0.00 

Page Write Rate 

0.00 

0.00 


0.00 

0.0 

0.0 

0.00 

Page Write I/O Rate 

0.00 

0.00 


0.00 

0.0 

0.0 

0.00 


Example n-n (continued on next page) 
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<EXAMPLE> 


Example n-n (Cont.) VAXcluster Multi-file Summary 


Free List Fault Rate 

8.60 

1.40 

0.24 

10.2 

3.4 

0.24 

Modified List Fault Rate 

5.83 

2.29 

0.00 

8.1 

2.7 

0.00 

Demand Zero Fault Rate 

12.96 

1.68 

0.24 

14.8 

4.9 

0.24 

Global Valid Fault Rate 

8.10 

2.69 

0.00 

10.8 

3.6 

0.00 

Wrt In Progress Fault Rate 

0.00 

0.00 

0.00 

0.0 

0.0 

0.00 

System Fault Rate 

4.92 

0.53 

0.18 

5.6 

1.8 

0.18 

Free List Size 

7586.30 

8630.14 

9665.06 

25881.5 

8627.1 

7586.30 

Modified List Size 

87.69 

324.07 

32.12 

443.8 

147.9 

32.12 


The following example shows how to use the <CODE_EXAMPLE> and 
<ENDCODE_EXAMPLE> tags in an informal example. 


g <EXAMPLE> 

<CODE_EXAMPLE> 

$! 

$! The next two lines redefine the cmd. line prompt to be the node 
$! name's initial. 

$! 

$ NODE :=='F$LOGICAL("SYS$NODE")' 

$ SET PROMPT=""F$EXTRACT (1,1,N0DE) ' : " 

$! 

<ENDCODE_EXAMPLE> 

<ENDEXAMPLE> 

This example produces the following output: 

$! 

$! The next two lines redefine the cmd. line prompt to be the node 
$! name's initial. 

$! 

$ NODE :=='F$LOGICAL("SYS$NODE")' 

$ SET PROMPT=" "F$EXTRACT (1,1, NODE) ' 

$! 

The following example shows how to use the <CODE_EXAMPLE> and 
<ENDCODE_EXAMPLE> tags in a formal example. 

§ <EXAMPLE>(Login Commands\login_exam) 

<CODE_EXAMPLE> 

$! 

$! The next two lines redefine the cmd. line prompt to be the node 
$! name's initial. 

$! 

$ NODE :=='F$LOGICAL("SYS$NODE") ' 

$ SET PROMPT=""F$EXTRACT (1,1, NODE) ' 

$! 

<ENDCODE_EXAMPLE> 

<ENDEXAMPLE> 


This example produces the following output: 





<EXAMPLE> 


Example n-n Login Commands 


$! 

$! The next two lines redefine the cmd. line prompt to be the node 
$! name's initial. 

$! 

$ NODE :=='F$LOGICAL("SYS$NODE") ' 

$ SET PROMPT=" "F$EXTRACT (1,1, NODE) ' 

$! 


The following example shows how to use the <INTERACTIVE>, 
<ENDINTERACTIVE>, <S>, and <u> tags within an example. Note that you 
should specify whatever space follows the system prompt within the <S> 
tag. 


<P>If you do not specify the full command line, DCL will prompt 
you for the missing information. For example, if you do not specify an 
input file and an output file when you enter the COPY command, you will 
be prompted as follows: 

<EXAMPLE>(Using the COPY Command\using_copy_command) 

<INTERACTIVE> 

<S>($ )<U>(COPY) 

<S>($_From: )<U>(INTERACT.SDML) 

<S>($_To: )<U>(NEWFILE.SDML) 

<ENDINTERACTIVE> 

<ENDEXAMPLE> 

This example produces the following output: 

If you do not specify the full command line, DCL will prompt you for the 
missing information. For example, if you do not specify an input file and 
an output file when you enter the COPY command, you will be prompted 
as follows: 

Example n-n Using the COPY Command 


$ COPY 

$_From: INTERACT.SDML 
$ To: NEWFILE.SDML 


The following example shows how to use the <SAMPLE_TEXT> tag within the 
<EXAMPLE> and <ENDEXAMPLE> tags to get specially formatted sample text 
within a formal example. 

<EXAMPLE>(Some Sample Text\sample_text) 

<SAMPLE_TEXT> 

<P>This paragraph shows how to use the <SAMPLE_TEXT> tag within the 
<EXAMPLE> and <ENDEXAMPLE> tags to get specially formatted sample 
text within a formal example. 

<ENDSAMPLE_TEXT> 

<ENDEXAMPLE> 


This example produces the following output: 



<EXAMPLE> 


Example n-n Some Sample Text 


This paragraph shows how to use the <SAMPLE_TEXT> 
tag within the <EXAMPLE> and <ENDEXAMPLE> tags to get 
specially formatted sample text within a formal example. 
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<EXAMPLE ATTRIBUTES> 


<EXAMPLE_ATTRIBUTES> 

Specifies attributes for the current example. 


SYNTAX f FLOAT 

<EXAMPLE_ATTRIBUTES>n KEEP 

[ MULTIPAGE 
[\ WIDE]) 


ARGUMENTS FLOAT 

Specifies whether the location of a one-page example is allowed to fioat. 
FLOAT indicates that if there is not enough room on the current page 
for the example, the text processor will fill the current page with the text 
from the source file that follows the <EXAMPLE> tag sequence, and place 
the example at the top of the next page of output. 

Float is the default for an example that has a caption and does not specify 
MULTIPAGE or KEEP. FLOAT has no effect for Bookreader output. 

KEEP 

Specifies whether the example is to be kept with the text that immediately 
precedes it. KEEP has no effect for Bookreader output. 

MULTIPAGE 

Specifies that the example has multiple elements, and that each element 
is allowed to break at the start of a new page. This argument is required 
if the example elements require more than one page. When an example is 
continued, the example caption is automatically repeated at the beginning 
of each new page of output. MULTIPAGE has no effect for Bookreader 
output. 

WIDE 

This is an optional keyword argument. It specifies that the width of the 
example exceeds the document’s default width for text. You can use WIDE 
with FLOAT, KEEP, or MULTIPAGE, or you can use WIDE as the only 
argument. Depending on the doctype, this argument is interpreted as 
follows: 

• If the doctype contains a left margin area that is normally used for 
headings, the example’s width will span that area as well as the 
normal text area. 

• If the document uses a multicolumn format, the example suspends 
multicolumn output while the example is processed. The example is 
output across two columns and then multicolumn output is restored. 

• Depending on the doctype, this argument provides a range of font sizes 
and font styles for examples. 
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<EXAMPLE ATTRIBUTES> 


related tags 


restrictions 


DESCRIPTION 


EXAMPLE 


• <EXAMPLE> 

• <EXAMPLE_FILE> 

• <EXAMPLE_SPACE> 

• <REFERENCE> 


Valid only in the context of an <EXAMPLE> tag. 


The <EXAMPLE_ATTRIBUTES> tag specifies attributes for the current 
example. By default, if an example does not fit on the current output 
page, it is placed at the top of the next page. The text that follows the 
example in the SDML file is used to fill the current output page. Thus, 
the example’s position in the text may change. It is said to float. Formal 
examples that fioat, then, may appear out of place. Use the <EXAMPLE_ 
ATTRIBUTES>(KEEP) tag to force the formal example to be kept with the text 
that immediately precedes it. 

If you think the example will be longer than a page, use the MULTIPAGE 
keyword argument to indicate that the example requires more than one 
page of output. The example will not be allowed to float. 

If the example is formal and you want to align the caption with the 
example (that has been extended into the left column), use the WIDE 
argument with both the <EXAMPLE_ATTRIBUTES> and <CODE_EXAMPLE> 
tags. 


This example shows how to use the MULTIPAGE and WIDE arguments to 
the <EXAMPLE_ATTRIBUTES> tag. Note the following: 

• The <VALID_BREAK> tags in the <CODE_EXAMPLE> provide the text 
formatter with information about suitable places to break pages. 

• Because the example is wide, the WIDE argument is specified not only 
for the <EXAMPLE_ATTRIBUTES> tag, but also for the <CODE_EXAMPLE> 
tag within the example. 
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<EXAMPLE ATTRIBUTES> 


<EXAMPLE>(Command Procedure for Adding a User\adduserex) 

<EXAMPLE_ATTRIBUTE S >(MULTIPAGE\WIDE) 

<CODE_EXAMPLE>(WIDE) 

$ ! 

$ ! ADDUSER.COM — Adds a new user to the system authorization file 

$ ! 

$ USERDISK = "WRKD$:" ! Default disk for new users 

$ UAF = "$AUTHORIZE" 

<VALID_BREAK> 

$ ON CONTROLY THEN GOTO CLEANUP 
$ ON WARNING THEN GOTO CLEANUP 

$ OLDDIR = F$LOGICAL("SYS$DISK") + F$DIRECTORY()' 

$ PREVPRIV = F$SETPRV("SYSPRV") 

$ IF .NOT, F$PRIVILEGE("SYSPRV") THEN GOTO NOPRIV 
$ SET DEFAULT SYS$SYSTEM 
$ ! 

$ ! Request account information 

$ ! 

$ INQUIRE USERNAME "Username" 

$ INQUIRE FULLNAME "Full name" 

$ SET TERMINAL/NOECHO 

$ INQUIRE PASSWORD "Password ["Username']" 

$ SET TERMINAL/ECHO 

$ IF PASSWORD .EQS. "" THEN PASSWORD = USERNAME 
$GET_GRP: 

$ INQUIRE GRP "UIC Group Number" 

$ IF GRP .EQS. "" THEN GRP = "*" 

$ WRITE SYS$OUTPUT "" 

$ WRITE SYS$OUTPUT "Determine the UIC from the following listing:" 

$ WRITE SYS$OUTPUT "" 

$ UAF SHOW ['GRP',*]/BRIEF 
$ INQUIRE UIC 

$ IF UIC .EQS. "" THEN GOTO GET_GRP 
$ IF F$LOCATE("[",UIC) .EQ. F$LENGTH(UIC) .AND. - 

F$LOCATE("<",UIC) .EQ. F$LENGTH(UIC) THEN UIC = "[" + UIC + "]" 

$ INQUIRE ACCOUNT "Account Name [VMS]" 

$ IF ACCOUNT .EQS. "" THEN ACCOUNT = "VMS" 

$ INQUIRE PRIVS "Privileges [NONE]" 

$ IF PRIVS .NES. "" THEN PRIVS = "/PRIV=(" + PRIVS + ")" 

$ USERDIR = F$EXTRACT(0,9,USERNAME) 

$ INQUIRE TMP "Login Directory [''USERDIR']" 

$ IF TMP .NES. "" THEN USERDIR = TMP 
$ INQUIRE TMP "Login Device ["USERDISK']" 

$ IF TMP .NES. "" THEN USERDISK = TMP 
$ DQUOTA = 0 

$ IF F$SEARCH("" USERDISK' [0,0]QUOTA.SYS") .EQS. "" THEN GOTO NQO 

$ DQUOTA = 1 

<VALID_BREAK> 

$ ! 

$ ! Restore prior working environment 

$ ! 

$CLEANUP: 

$ SET TERMINAL/ECHO 
$ PREVPRIV = F$SETPRV(PREVPRIV) 

$ SET DEFAULT 'OLDDIR' 

$ EXIT 

$ ! 

$ ! In case proper privileges are not set 

$ ! 

s$NOPRIV: 

$ WRITE SYS$OUTPUT "You need SETPRV or SYSPRV privilege to run this procedure" 

$ GOTO CLEANUP 

<ENDCODE_EXAMPLE> 

<ENDEXAMPLE> 


This example produces the following output: 
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<EXAMPLE ATTRIBUTES> 


Example n-n Command Procedure for Adding a User 


$ ! 

$ ! ADDUSER.COM — Adds a new user to the system authorization file 
$ ! 

$ USERDISK = "WRKD$;" ! Default disk for new users 

$ UAF = "$AUTHORIZE" 

$ ON CONTROLY THEN GOTO CLEANUP 
$ ON WARNING THEN GOTO CLEANUP 

$ OLDDIR = F$LOGICAL("SYS$DISK") + F$DIRECTORY()' 

$ PREVPRIV = F$SETPRV("SYSPRV") 

$ IF .NOT. F$PRIVILEGE("SYSPRV") THEN GOTO NOPRIV 
$ SET DEFAULT SYS$SYSTEM 
$ ! 

$ ! Request account information 

$ ! 

$ INQUIRE USERNAME "Username" 

$ INQUIRE FULLNAME "Full name" 

$ SET TERMINAL/NOECHO 

$ INQUIRE PASSWORD "Password ["Username']" 

$ SET TERMINAL/ECHO 

$ IF PASSWORD .EQS. "" THEN PASSWORD = USERNAME 
$GET_GRP: 

$ INQUIRE GRP "UIC Group Number" 

$ IF GRP .EQS. "" THEN GRP = "*" 

$ WRITE SYS$OUTPUT "" 

$ WRITE SYS$OUTPUT "Determine the UIC from the following listing:" 

$ WRITE SYS$OUTPUT "" 

$ UAF SHOW ['GRP',*]/BRIEF 
$ INQUIRE UIC 

$ IF UIC .EQS. "" THEN GOTO GET_GRP 
$ IF F$LOCATE("[",UIC) .EQ. F$LENGTH(UIC) .AND. - 

F$LOCATE("<",UIC) .EQ. F$LENGTH(UIC) THEN UIC = "[" + UIC + "]" 

$ INQUIRE ACCOUNT "Account Name [VMS]" 

$ IF ACCOUNT .EQS. "" THEN ACCOUNT = "VMS" 

$ INQUIRE PRIVS "Privileges [NONE]" 

$ IF PRIVS .NES. "" THEN PRIVS = "/PRIV=(" + PRIVS + ")" 

$ USERDIR = F$EXTRACT(0,9,USERNAME) 

$ INQUIRE TMP "Login Directory ["USERDIR']" 

$ IF TMP .NES. "" THEN USERDIR = TMP 
$ INQUIRE TMP "Login Device ["USERDISK']" 

$ IF TMP .NES. "" THEN USERDISK = TMP 
$ DQUOTA = 0 

$ IF F$SEARCH(""USERDISK' [0,0]QUOTA.SYS") .EQS. "" THEN GOTO NQO 
$ DQUOTA = 1 
$ ! 

$ ! Restore prior working environment 

$ ! 

$CLEANUP: 

$ SET TERMINAL/ECHO 
$ PREVPRIV = F$SETPRV(PREVPRIV) 

$ SET DEFAULT 'OLDDIR' 

$ EXIT 

$ ! 

$ ! In case proper privileges are not set 

$ ! 

$NOPRIV: 

$ WRITE SYS$OUTPUT "You need SETPRV or SYSPRV privilege to run this procedure" 
$ GOTO CLEANUP 
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<EXAMPLE FILE> 


<EXAMPLE_ 

.FILE> 

Causes a separate file containing an example to be included in the source file. 

SYNTAX 

<EXAMPLE_FILE>fffte spec) 

ARGUMENTS 

file spec 

Specifies the file containing the example. The file can be a logical name. 
See the <INCLUDES_FILE> tag description for information on how to define a 
logical name. 

related tags 

• <EXAMPLE> 

• <EXAMPLE_ATTRIBUTES> 

• <EXAMPLE_SPACE> 

• <REFERENCE> 

restrictions 

Valid only in the context of an <EXAMPLE> tag. 

DESCRIPTION 

The <EXAMPLE_FILE> tag causes a separate file containing an example to 
be included in the source file. 

The included file should be an SDML file containing a complete coded 
example, perhaps using <CODE_EXAMPLE> or <INTERACTrVE> tags. If the 
<EXAMPLE> tag specifies the WIDE argument, the included file must 
specify the WIDE argument in the appropriate tags. For more information 
on correctly coding examples and example files, see VAX DOCUMENT 
Producing Online and Printed Documentation. 

You can give the <EXAMPLE_FILE> tag a logical name for an argument. 
Define the logical name by first entering an <INCLUDES_FILE> tag in the 
profile. The information in that tag is used to make the proper logical 
name assignment during processing. 

EXAMPLE 

See the example in the discussion of the <EXAMPLE> tag. 


1-75 







<EXAMPLE SPACE> 


<EXAMPLE SPACE> 


Leaves space for an example to be pasted in during final production. 


SYNTAX 


<EXAMPLE_SPACE>r{ } /' 


ARGUMENTS value 

Specifies the size of the space in picas, a scale used by typesetters. There 
are approximately 6 picas in an inch (and 12 points in a pica). Thus, if 
the example is 4 inches high, you should specify 24 picas. The value must 
not exceed page length limitations for the current doctype. If you omit the 
value, a default value of 2 picas is used. 

FULL_PAGE 

This keyword specifies that a full blank page be reserved for the example. 
For Bookreader output, a small amount (smaller than a printed page or a 
Bookreader page) of blank space is left. 

text 

This is an optional argument. It specifies the text to be printed in the 
center of the space. (For example, an art file number, a file name that 
contains the example, or some other note.) 


related tags 


• <EXAMPLE> 

• <EXAMPLE_ATTRIBUTES> 

• <EXAMPLE_FILE> 

• <REFERENCE> 


restrictions Valid only in the context of an <EXAMPLE> tag. 

The value argument must not exceed page length limitations. 


DESCRIPTION The <EXAMPLE_SPACE> tag, leaves space for an example to be pasted in 

during final production. Any text you supply as the second argument is 
printed in the center of the space. 


EXAMPLE This example shows how to use the <EXAMPLE_SPACE> tag. 

<EXAMPLE> (Completing Form DD-214\annotateci_dd214_exam) 

<EXAMPLE_ATTRIBUTES>(wide) 

<EXAMPLE_SPACE>(12\Photo-reduced copy of the end of DD-214 here.) 

<ENDEXAMPLE> 


This example produces the following output: 
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<EXAMPLE SPACE> 


Example n-n Completing Form DD-214 
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<FCMD> 


<FCMD> 

Specifies the keyword portion of a command/parameter pair in a format 
section. 

SYNTAX 

<FCMD> (keyword [\ parameters]) 

ARGUMENTS 

keyword 

Specifies the ke3nvord portion of the command/parameter pair. 

parameters 

This is an optional argument. It specifies the command parameters, if any. 

Parameters specified in this argument differ in your output from 
arguments specified using the <FPAKMS> tag. If you do specify the <FCMD> 
tag with a null second argument, it is recommended that you explicitly 
declare the absence of parameters using the <FPAKMS> tag, as follows: 

<FCMD>(KEYWORD) <FPARMS>() 

If you do not specify a second argument, and if the <FPARMS> tag is not 
specified, the tag translator issues a warning message that it has no 
explicit declaration of parameters. 

related tags 

• <FORMAT> 

• <FPARM> 

• <FPARMS> 

restrictions 

Valid only in the context of a <FORMAT> tag. 

DESCRIPTION 

The <FCMD>tag specifies the ke3rword portion of a command/parameter pair 
in a format section. You can specify the keyword’s argument list as the 
second argument to this tag. The <FCMD>tag should be used only in the 
context of a format section. A format section is established by <FORMAT> 
and <ENDFORMAT> tags. 

If the text of the parameters argument does not fit on one line, the text 
formatter chooses suitable line breaks based on the presence of spaces. 
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<FCMD> 


EXAMPLES The following example specifies a single command keyword. The <FPARMS> 

tag is explicitly specified as null. The output that this example produces is 
shown in Output Sample 1. 


Q <FORMAT> 

<FCMD>(exit) <FPARMS>() 
<ENDFORMAT> 


The following example specifies the command keyword and its parameters 
using both the <FCMD> and <FPARMS> tags. The output that this example 
produces is shown in Output Sample 2. 

g <FORMAT> 

<FCMD>(append) <FPARMS>(input-file-spec output-file-spec) 

<ENDFORMAT 


The following example specifies both the keyword and the parameters 
arguments to the <FCMD> tag. The output that this example produces is 
shown in Output Sample 3. 

Notice the difference between Output Sample 2 and 3. In Sample 2, space 
is left between the ke 3 rword and the parameters. In Sample 3, no space is 
left. The formatting is produced by the syntax used in the <FCMD> tag. 


g <FORMAT> 

<FCMD>(f$element\(element-number,delimiter,string) ) 

<ENDFORMAT 

The following example shows how to control the interpretation of 
keywords tagged with the <KEYWORD> tag when they are mixed in with 
the parameters of a format specification. The output that this example 
produces is shown in Output Sample 4. 


gj <FORMAT> 

<FCMD>(set protectionX[=code]<keyword>(/DEFAULT)) 
<ENDFORMAT 


The following example specifies the command keyword and its parameters 
using the <FCMD>, <FPARMS>, and <FPARM> tags. The output that this 
example produces is shown in Output Sample 5. 


g <FORMAT> 

<FCMD>(append) <FPARMS>(one parameter) <FPARM>(two parameters) <FPARM>(three parameters) 
<ENDFORMAT 


OUTPUT exit 

SAMPLE 1 


OUTPUT 
SAMPLE 2 


append input-file-spec output-file-spec 



<FCMD> 


OUTPUT 

SAMPLES 

f $element ('e/e/77enf-na/7?iber, delimiter, string) 

OUTPUT 

set protection/i=coc/ey/DEFAULT 

SAMPLE 4 


OUTPUT 

append one parameter 

SAMPLES 

two parameters 


three parameters 
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<FIGURE> 


<FIGURE> 

Labels the beginning of a figure. 

FORMAT 

<FIGURE>/f//gt/fe caption[\ symbol name])] 

ARGUMENTS 

figure caption 

This is an optional argument. It specifies the text of the caption to be 
associated with the figure. The figure caption and the associated figure 
number will be included in the table of contents for the document. If the 
body of the figure spans more than a single page of text, the figure caption 
is repeated on each page on which the figure continues. 


symbol name 

This is an optional argument. It specifies the symbolic identifier to be 
associated with the example. The S 5 nnbol name is assigned a numeric 
value, which becomes the current figure number. The symbol name and its 
value are placed in the symbol table. 

Symbol names must not exceed 31 characters and must only contain 
alphabetic letters, numbers, or underscores in them. Do not begin a 
symbol name with an underscore. 

related tags 

• <FIGURE_ATTRIBUTES> 

• <FIGURE_FILE> 

• <FIGURE_SPACE> 

• <ICON> 


• <ICON_FILE> 


• <LINE_ART> 


• <REFERENCE> 

restrictions 

Invalid in the context of a <FOOTNOTE> tag. 

required 

terminator 

<ENDFIGURE> 

DESCRIPTION 

The <FIGURE> tag labels the beginning of a figure. A formal figure has a 
number and a caption, can be cross-referenced, and is listed in the table 
of contents. An informal figure does not have a number or a caption, 
cannot be cross-referenced, and is not listed in the table of contents. 
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<FIGURE> 


A formal figure is sometimes long. If you think one of your figures 
will be longer than a page, label it as a multipage figure in the 
<FIGURE_ATTRIBUTES> tag. See the <FIGIIRE_ATTRIBUTES> tag description 
for more information. 

Note the following when processing a book for Bookreader display: 

• You must use the symbol name argument to process a formal figure for 
Bookreader display. 

• DOCUMENT automatically creates pop-up windows for all formal 
figures. 

• When introducing and cross-referencing a formal figure, you must use 
the <REFERENCE> tag to create a hotspot. Hotspots are regions in 
the windows you click on with your mouse to access cross-referenced 
topics. 

• You can use the <ONLlNE_POPUP> tag if you want to make informal 
figures pop up. 

When you print an informal or formal figure, or process an informal figure 
for Bookreader display, the figure is indented in the same way the regular 
text is for the particular doctype you are using. 


EXAMPLES In the following example, the <FIGURE_ATTRIBUTES> tag contains a KEEP 

argument, to specify that the figure should be kept with the immediately 
preceding text. The <line_ART> tag also has a KEEP argument, to specify 
that the figure should not break across pages. 

The figures you are able to create using your terminal keyboard may be 
adequate for draft purposes, but may not be acceptable in the context of 
typeset output. 

Q <FIGURE>(Example of Terminal-Created Art\transfer_vector_exam) 

<FIGURE_ATTRIBUTES>(KEEP) 

<LINE_ART>(KEEP) 

Shareable Image Executable Image 

H-(• H-—+ 

+-1 Vector A |<-+ | . | 

I +-+ ,1 .1 

I +— I Vector B 1 <-+ +-Invoke A | 

I I +-+ I I . I 

+—>1 II I . I 

I I Routine A | +-Invoke B | 

II I I . I 

I +-+ I . I 

+->l I +-+ 

I Routine B | 

I I 

H---b 

<ENDLINE_ART> 

<ENDFIGURE> 

This example produces the following output: 
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<FIGURE> 


Figure n-n Example of Terminal-Created Art 


Shareable Image 
+- + 

+-I Vector A |<- 

I H-+ 

I +—I Vector B |<-+ 

I I +-+ I 

+—>1 I I 

I I Routine A | + 

I I I 

I ^- 

+->1 1 

1 Routine B | 

I I 

+-+ 


+ 

I 

+• 


Executable Image 

+-+ 

I - I 

I . I 

— Invoke A | 

I • I 

I . I 

— Invoke B 1 

I . I 

I . I 

+ - + 


The following example shows how to code a figure that is allowed to 
extend over several pages. The MULTIPAGE argument to the <FIGURE_ 
ATTRIBUTES> tag tells the text formatter that the figure is more than one 
page. Note that the text formatter does not break a large figure and adjust 
its portions on multiple pages; rather, MULTIPAGE indicates that the 
text formatter outputs the text, “Cont’d on next page”, to indicate that the 
figure continues. The figure that you create should fit on one page. If it 
does not, the remainder of the figure does not print, but the text, “Cont’d 
on next page” still appears. For Bookreader output, the words “Cont’d on 
next page” do not appear. 


<FIGURE>(Digital Multinational Character Set\char_set_fig) 
<FIGURE_ATTRIBUTES>(MUltipage) 

<FIGDRE_FILE>{LN03\character_set.SIX\2 7) 
<FIGURE_FILE>(PS\character_set.PS\27) 

<FIGURE_FILE>(BOOKREADER\character_set.BRF\54) 
<FIGURE_FILE>(LN03\character_set2.SIX\27) 
<FIGURE_FILE>(PS\character_set2.PS\27) 

<FIGURE_FILE>(BOOKREADER\character_set2.BRF\54) 

<ENDFIGURE> 


This example produces the following output: 
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<FIGURE> 


Figure n-n Digital Multinational Character Set 
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<FIGURE> 


Figure n-n (Cont.) Digital Multinational Character Set 



The following example shows how to code an informal figure that appears 
within text without floating, without a number, and without a caption. 


<P> A VT200 is different from a VT300 terminal. 

The following figures illustrate an obvious difference in hardware between 
the two types of terminals. 

<FIGURE> 

<FIGURE_FILE>(LN03\VT_Terminals.SIX\21) 
<FIGURE_FILE>(PS\VT_Terminals.PS\21) 

<FIGURE_FILE>(BOOKREADER\VT_Terminals.BRF\21) 

<ENDFIGURE> 

<P> 

The first figure shows that . . . 

This example produces the following output: 
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<FIGURE> 


A VT200 is different from a VT300 terminal. The following figures 
illustrate an obvious difference in hardware between the two types of 
terminals. 




ZK>9670.G£ 


The first figure shows that ... 
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<FIGURE ATTRIBUTES> 


related tags 


restrictions 


DESCRIPTION 


EXAMPLE 


leftmost position of the image area, you still must use the WIDE 
argument to the <FIGURE_FILE> tag to align the figure itself at the 
leftmost position of the image area. 


• <FIGURE> 

• <FIGURE_FILE> 

• <FIGURE_SPACE> 


Valid only in the context of a <FIGURE> tag. 


The <FIGURE_ATTRIBUTES> tag specifies the placement of a figure on 
the page. Use the tag in the context of a formal figure to adjust the 
pagination and placement of the figure. See the <FIGURE> tag description 
for more information about formal and informal figures. 

If the figure is formal and you need a wide caption that extends into the 
leftmost position of the image area, use the WIDE argument. You still 
must use the WIDE argument to the <FIGURE_FILE> tag to align the figure 
itself at the leftmost position of the image area. 

A formal figure is sometimes long. If you think one of your figures will be 
longer than a page, use the MULTIPAGE argument. Your figure will then 
be placed on the current page and continued on following pages, as space 
permits. 

A multipage figure can contain one or more elements (that is, one or more 
<FIGURE_FILE>, <FIGURE_SPACE>, and <CODE_EXAMPLE> tags). 

If your multipage figure (consisting of a single <CODE_EXAMPLE>) contains 
no blank lines, you might want to insert <VALID_BREAK> tags in the figure. 
The <VALID_BREAK> tags specify reasonable page breaking points. See the 
description of the <VALID_BREAK> tag for more information. 

A one-page (or smaller) formal figure’s position in the output file can 
change. If the figure does not completely fit on the current page, the 
entire figure is placed at the top of the next page. The text that follows 
the example in the SDML file then is used to fill the current output 
page. When the figure’s position can change, the figure is said to float. 
Formal figures that float, then, may appear out of place. Use the <FIGURE_ 
ATTRIBUTES>(KEEP) tag to force the figure to be kept with the text that 
immediately precedes it. 

Floating is the default for a formal figure that fits on one page. If you 
want an informal figure to float, you must specify the FLOAT argument if 
your figure fits on one page. A multipage figure never floats. 


See the examples in the discussion of the <FIGURE> tag. 
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<FIGURE FILE> 


1 

111 

oc 

ID 

o 

LL 

V 

_FILE> 


Includes a graphics file in your output file if the output device has graphics 
capability. 

FORMAT 

<FlGUREJFlLE>(targetdevicel^ ISPACE^ } 


I \ vertical size 1 n ^y/D£/i 

1 1 FULL_PAGE j' 


ARGUMENTS target device 

Specifies a ke 5 rword indicating the output device for the graphics 
file. Keywords are provided both for devices that do (LN03, PS, and 
Bookreader) and do not (LINE, MAIL, and TERMINAL) support graphics. 
Each keyword allows you to insert the necessary amount of white space 
for the specific output device; keywords for devices that do not support 
graphics allow you to insert blank space in place of a figure. The following 
table lists the output devices and expected output for each ke 3 rword. 


Keyword 

Device 

Output 

BOOKREADER 

DECwindows screen 

The specified graphics file is output 
online using Bookreader. 

LN03 

LN03 Laser Printer 

The specified sixel graphics file is 
output as a figure. 

PS 

PrintServer 40 or 

LN03R ScriptPrinter 

The specified PostScript graphics 
file^ is output as a figure. 

LINE 

MAIL 

TERMINAL 

Line Printer 

If specified, blank space is output 
with the file spec argument written 
in that blank space. Use only one 


of these three keywords to indicate 
a monospaced destination. 


^ PostScript graphics files must conform to the Encapsulated PostScript File Format 
published by Adobe Systems, Inc. 


If you specify the <figure_file> tag for a given device and subsequently 
process the file on another output device, no output will appear in the 
position of the <FIGURE_FILE> tag. 

file spec 

Specifies the graphics file. 
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<FIGURE FILE> 


related tags 


restrictions 


SPACE 

This ke 5 rword lets you reserve blank space in the output file for a figure. 
You can use it if you do not use the file spec argument. Use SPACE to 
reserve space for art that will be pasted in at a later date or when you 
expect to process a file for more than one output device, but do not have 
graphics files for all devices. 

vertical size 

Specifies the vertical size of the printed graphic in picas (6 picas equal an 
inch, and 12 points equal a pica). This argument may be a nonnegative 
integer or decimal number, including zero. 

FULL_PAGE 

You can use FULL_PAGE if you do not use the vertical size argument. It 
specifies that a full blank page be reserved for the figure. For Bookreader 
output, a small amount (smaller than a printed page or a Bookreader 
page) of blank space is left. 

WIDE 

This is an optional keyword argument. If you use it, it must come last 
in the argument list. WIDE specifies that the grapMc be aligned at the 
leftmost position of the image area (if your doctype uses a wide left gutter). 

Note: If you use a <figure_file> tag and specify the WIDE argument 
to that tag, which makes the figure itself align at the leftmost 
position of the image area, you still must use the WIDE argument 
to the <FIGURE_ATTRIBUTES> tag to align the caption at the leftmost 
position of the image area. 


• <FIGURE> 

• <FIGIJRE_ATTRIBUTES> 

• <ICON> 

• <ICON_FILE> 

• <LINE_ART> 

• <REFERENCE> 

• <SET_FIGURE_FILE_SPACING_DEFAULT> 


Valid only in the context of a <FIGURE> tag. 

You must use an LN03 or POSTSCRIPT laser printer to print graphics files 
or use Bookreader to view graphics files online. 

If you use the <FIGURE_FILE> tag in a file that you process for multiple 
output devices, you must supply a tag for each device, using the SPACE 
argument for devices for which you do not have graphics. 



<FiGURE FILE> 


DESCRIPTION The <FIGURE_FILE> tag includes a graphics file in your output file if the 

output device has graphics capability. 

To ensure that your figure is the right size for inclusion with your output, 
follow this procedure: 

1 Create and print your graphics file full size (100 percent). 

2 Measure it. 

3 If the figure at 100 percent is the desired size and will fit on the page, 
incorporate that measurement into the <FIGUIIE_FILE> tag. Otherwise, 
use the Graphics Editor to reduce the figure to the desired size. 

4 Process the SDML file that the Graphics Editor produces and print the 
output. See the VAX DOCUMENT Graphics Editor User’s Guide for 
information on using the Graphics Editor. 

5 Evaluate the result. If it is not satisfactory, change either of the 
following: 

• One or both ke 5 rwords specified in the <FIGURE_FILE> tag to correct 
the alignment, spacing, or both, for the figure 

• The graphics file itself to correct the size, content, or both 

Because there is an interaction between changing the contents or size of 
the graphics file and specifying its placement in the <FIGURE_FILE> tag, 
satisfactory results may require several loops through the process, much 
like coding complicated tables. Refer to VAX DOCUMENT Producing 
Online and Printed Documentation for information on coding tables. 

If you plan to process your file for more than a single destination, you can 
use multiple <FIGURE_FILE> tags to ensure that the appropriate figure will 
be included for the appropriate destination; an example of this coding is 
given in the following section. If you use multiple <FIGURE_FILE> tags in 
this way, you should specify only a single <FIGURE_FILE> tag for all the 
monospaced destination keywords (MAIL, TERMINAL, or LINE). 


EXAMPLES The following example shows how to code a captioned, numbered figure. 

The figure would appear in the table of contents. 

Q <FIGURE>(The Front View) 

<FIGURE_FILE>(LN03\Frontpanel.SIX\6) 

<ENDFIGURE> 


The following example shows how to code an uncaptioned, unnumbered 
figure. The figure would not appear in the table of contents. 
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<FIGURE FILE> 


g <FIGURE> 

<FIGURE_FILE>(LN03\Example_Figure.PS\10) 

<ENDFIGURE> 


The following example shows how to use multiple <FIGURE_FILE> tags so 
that your figure will process for multiple destinations. If you process this 
file for a POSTSCRIPT destination, the file included is DOG_TRAINING.PS. 
If you process this file for an LN03 laser printer destination, the file 
included is DOGJTRAINING.SIX. If you process this file for a line printer 
destination, no file is included; instead, 10 blank lines are reserved for 
the graphic. If you process this file for Bookreader, the file included is 
DOG_TRAINING.BRF. 

g <FIGURE> 

<FIGURE_FILE>(LN03\Dog_Training. SIXMO) 

<FIGURE_FILE>(PS\Dog_Training.PS\10) 

<FIGURE_FILE>(LINE\SPACE\10) 

<FIGURE_FILE>(BOOKREADER\Dog_Training.BRF\10) 

<ENDFIGURE> 


This example produces the following output: 



ZK-9571-GE 
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<FIGURE SPACE> 


<FIGURE_SPACE> 

Marks the space required for a figure that will be pasted in during final 
production. 



DESCRIPTION The <FIGURE_SPACE> tag marks the space required for a figure that will be 

pasted in during final production. 

If you specify some descriptive text in the second argument, that text is 
output in the middle of the space left for the figure. 
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<FIGURE SPACE> 


EXAMPLES The following example shows how to leave space for a figure that is 18 

picas long. Notice that 18 picas (or 3 inches or 216 points) of space are left 
for the figure. 


Q <FIGURE>(Illustration of a Computer Terminal\terminal_fig) 
<FIGURE_SPACE>(18\An illustration of a computer terminal.) 
<ENDFIGURE> 


This example produces the following output: 

Figure n-n Illustration of a Computer Terminal 


An illustration of a computer terminal. 


The following example shows how to leave space for a figure that will take 
one page. 

§ <FIGURE>(Illustration of a Garage\garage_fig) 

<FIGURE_SPACE>(FULL_PAGE\An illustration of a garage.) 

<ENDFIGURE> 

This example produces output like that found on the following page. 
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Figure n-n Illustration of a Garage 


An illustration of a garage. 


DECLIT AA VAX JT94C 

VAX DOCUMENT using global 
•tags 
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<FILE SPEC> 


<FILE_SPEC> 

Allows you to use a file specification that contains angle brackets as an 
argument to a tag without VAX DOCUMENT interpreting that file specification 
as a tag. 

FORMAT 

<FILE_SPEC>('/7/e specification) 

ARGUMENTS 

file specification 

Specifies the file specification that contains angle brackets. 

related tags 

• <ELEMENT> 

• <EXAMPLE_FILE> 

• <FIGURE_FILE> 

• <ICON_FILE> 

• <INCLUDE> 

• <INCLUDES_FILE> 

• <TABLE_FILE> 

DESCRIPTION 

The <FILE_SPEC> tag allows you to use a file specification that contains 
angle brackets as an argument to a tag that lets you include external files 
without VAX DOCUMENT interpreting that file specification as a tag. 

A complete list of tags that let you include external files is found in the 
“Related Tags” section of this tag description. 

Some keyboards do not provide square brackets, ([) and (]), so it is common 
for the directory portion of a file specification to be delimited by angle 
brackets. Because VAX DOCUMENT would normally interpret text within 
angle brackets as an SDML tag, the <FILE_SPEC> tag converts any angle 
brackets in its argument into the corresponding square brackets. 

You do not have to use the <FILE_SPEC> tag to specify logical names in a 
file specification whose equivalence strings contain angle brackets. 

EXAMPLE 

The following example shows how to use the <FILE_SPEC> tag. 


<figure_file>(ln03\<file_spec>(mydisk:<figure>diagram.six)\20) 
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The directory name in this file specification would normally be seen as 
a <FIGURE> tag, which would lead to erroneous results. Because the file 
specification is used as an argument to the <FILE_SPEC> tag, the angle 
brackets are converted to square brackets before the apparent <FIGUIIE> 
tag is recognized. Thus, the example is equivalent to the following: 

<figure_file>(ln03\mydisk:[figure]diagram.six\20) 
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<FINAL CLEANUP> 


<FINAL_CLEANUP> 

Provides explicit formatting instructions to the text formatter to be used for 
final formatting and clean up. 


COLUMN_BREAK 1 
UNE_BREAK > 
PAGE_BREAK V 
SPECIAL_BREAK J 


FORMAT 


<FINAL_CLEANUP>(' 


ARGUMENTS COLUMN_BREAK 

Specifies that a new column of text be started at the place where the 
<FINAL_CLEANUP> tag occurs. This argument is only valid in a two-column 
doctype: the ARTICLE or REPORTTWOCOL doctypes, described in VAX 
DOCUMENT Using Doctypes and Related Tags. 

LINE_BREAK 

Specifies that the following text begin a new line of output. 

PAGE_BREAK 

Specifies that the following text begin a new page of output. 

SPECIAL_BREAK 

Specifies a special break when vertical spacing appears to be lost. In some 
circumstances, the output of a two-column page may have had some of 
its vertical spacing lost due to the text formatter processing; for example, 
a heading tag may not have any space before it. You can correct this by 
placing the <FINAL_CLEANUP>(SPECIAL_BREAK) tag in your file between the 
words that are ouput on the final line of the first column. 

Use the SPECIAL_BREAK argument only if there is a spacing problem 
and only after you are ready to give your document a final format check, 
because changes to the source file may help the text formatter resolve the 
spacing problem. 


related tags • <C0LUMN> — in the article and REPORT.TWOCOL doctypes, 

described in VAX DOCUMENT Using Doctypes and Related Tags. 

* <LINE> 

• <PAGE> 


restrictions Should be used only for final production formatting. 

If you use the <FINAL_CLEANUP>(PAGE_BREAK) tag in a table to force a page 
break, the table headings are not repeated on the page after the break. 
You must repeat the <TABLE_HEADS> tag immediately after the <FINAL_ 
CLEANUP>(PAGE_BREAK) tag to restore the default table headings. Headings 


1-98 




<FINAL CLEANUP> 


are repeated on each page of a table only when DOCUMENT is allowed to 
break the table across pages. 

In doctypes with right-justified text (that is, text aligned against the 
right margin), the <FINAL_CLEANUP>(LINE_BREAK) tag must be on the same 
line of the text you want broken. 


DESCRIPTION The <FINAL_CLEANUP> tag provides explicit formatting instructions to the 

text formatter to be used for final formatting and clean up. The <FINAL_ 
CLEANUP> tag is not a generic markup tag; it explicitly instructs the text 
formatter to change aspects of the page makeup. 

In a single-column doctype, the <FINAL_CLEANUP> tag enables you to 
specify line breaks and page breaks using the LINE_BREAK and PAGE_ 
BREAK arguments. In a two-column doctype, you can use the COLUMN_ 
BREAK argument to start a new column of text. Use the SPECIAL_ 
BREAK argument only rarely at the final stage of production to affect the 
final format of your document. 

When you are working with the ARTICLE or REPORT.TWOCOL doctypes, 
you may need to make some final adjustments when your text is complete. 
The text formatter makes formatting decisions based on your source 
file. It is more difficult for the text formatter to create a well-formatted 
two-column page than a well-formatted one-column page. Therefore, the 
output of these doctypes may need additional attention, using the <FINAL_ 
CLEANUP> tag, during the last stage of production. 

Using the <FINAL_CLEANUP> tag has no effect for Bookreader output. 


EXAMPLES The following example shows how final production might use the <FINAL_ 

CLEANUP>(LINE_BREAK) tag in the front matter of a book to maike it look 
better. 

Q <FRONT_MATTER>(front) 


<REVISION_INFO>(Revision/Update Information:\This revised manual 
supersedes 

the <final_cleanup>(line_break)<emphasis>(VAX DOCUMENT User Manual, Volume 1 Version 1.1) 
<oparen>Order Number AA—JT84B—TE<cparen>.) 
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The following example shows how final production might use the <FINAL_ 
CLEANUP>(PAGE_BREAK) tag, because the information in these specific 
headings might look better or fit better on separate pages. 

g <HEAD1>(Survey Results) 


<FINAL_CLEANUP>(page_break) 
<HEAD2>(Brand X) 
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<FOOTNOTE> 


<FOOTNOTE> 


Creates a footnote in text and tables. In text, this tag specifies the footnote 
character and footnote text, and places the footnote text at the bottom of 
the page or in a pop-up window for Bookreader output. In a table, this tag 
specifies the footnote character and footnote text; the <footref> tag outputs 
the footnote character. Footnotes in tables appear at the bottom of the table. 


FORMAT <FOOTNOTE>('c/7a/' 1 footnote text) 


ARGUMENTS char 

Specifies the footnote character. The character can be a single character, 
a number, or one of the following keywords denoting special characters 
associated with footnote references: 

DAG (t) 

DDAG ($) 

R(®) 

S(§) 

TM (™) 

When placing a footnote in a table, you must use a number or one of the 
keywords as the footnote character. 

If you use more than one of the keywords allowed for table footnotes, you 
should declare them in the following order to ensure that the footnotes 
print in the correct order at the bottom of the page or in the pop-up 
window for Bookreader output: 

1 TM 

2 R 

3 S 

4 DAG 

5 DDAG 

footnote text 

Specifies the text of the footnote. 


rOldtOd tSQS * <FOOTNOTE_TEXT> 

• <FOOTREF> 


restrictions 


Invalid in the context of a <MATH> tag. 





<FOOTNOTE> 


The following restrictions apply to footnotes in text: 

• Do not place the following tags within an argument to the <FOOTNOTE> 
tag: <CODE_EXAMPLE>, <EXAMPLE>, <FIGURE>, <HEADn>, <MATH>, 
<NOTE>, or <TABLE>. 

• Do not place more than four footnotes within a stacked list or a 
monospaced example. 

The following restrictions apply to footnotes in a table: 

• Use the <FOOTNOTE> and <footref> tag combination in a table. It is 
the <FOOTREF> tag that causes the footnote character to appear. Place 
the <FOOTREF> tag in the argument to the <TABLE_ROW> tag at the end 
of the argument you want to footnote. 

• Declare all table footnotes at the top of the table using a <FOOTNOTE> 
tag just after the <table_setup> tag. Do not specify <footnote> tags 
in a nested table. 

• Do not specify more than twelve footnotes in a table. If you use a 
nonnumeric footnote character, there can be no more than seven 
numeric footnotes. 

• Footnotes in the body of a multipage table appear at the bottom of a 
page only if they are called out on that page. 

• Footnotes called out in the heading of a multipage table appear at the 
bottom of each page of the table. 


DESCRIPTION The <FOOTNOTE> tag creates a footnote in text and tables. In text, this 

tag specifies the footnote character, which appears in the text at the place 
where the tag is located, and footnote text. The footnote text appears at 
the bottom of the page or in a pop-up window for Bookreader output 
(once you click on the superscript footnote reference, which is a hotspot). 
In a table, this tag specifies the footnote character and footnote text; the 
<FOOTREF> tag outputs the footnote character. Footnotes in tables appear 
at the bottom of the table for both printed and Bookreader output. 

For footnotes in a heading, on a copyright page, or on a title page, use the 
<FOOTNOTE_TEXT> and <FOOTREF> tag combination. See the <FOOTNOTE_ 
TEXT> and <FOOTREF> tag descriptions for more information. 


EXAMPLES The following example shows how to place a footnote in text. 

Q <P>The <TAG>(footnote) tag produces output that looks like 
this.<FOOTNOTE>(1\Note how 

footnote text appears at the bottom of the page or in a pop-up window for 
Bookreader output.) 


This example produces the following output: 

The <FOOTNOTE> tag produces output that looks like this.^ 
The following example shows how to use a footnote in a table. 


^ Note how footnote text appears at the bottom of the page or in a pop-up window for Bookreader output. 





<FOOTNOTE> 


§ <TABLE>(Rules for Determining Expression Modes\express_modes_tab) 
<TABLE_ATTRIBUTES>{MULTIPAGE) 

<TABLE_SETUP>(2\43) 

<FOOTNOTE>(1\A footnote in a table.) 

<TABLE_HEADS>(Expression\Value Type) 

<TABLE_ROW>(Integer value\Integer) 

<TABLE_ROW>(String value\String<FOOTREF>(1)) 

<TABLE_ROW>(Integer lexical function\Integer) 

<TABLE_ROW>(String lexical functionXString) 

<TABLE_ROW>(Integer symbol<FOOTREF>(1)\Integer) 

<TABLE_ROW>(String symbol\String) 

<TABLE_ROW>(Any value .AND. or .OR. any value\Integer) 
<TABLE_ROW>(Any value\Integer) 

<TABLE_ROW> (Any valueMnteger) 

<ENDTABLE> 


This example produces the following output: 


Table n.n Rules for Determining Expression Modes 


Expression 

Value Type 

Integer value 

Integer 

String value 

String^ 

Integer lexical function 

Integer 

String lexical function 

String 

Integer symbof 

Integer 

String symbol 

String 

Any value .AND. or .OR. any value 

Integer 

Any value 

Integer 

Any value 

Integer 

^A footnote in a table. 


The following example shows how to use the <FOOTNOTE> and <FOO'KffiF> 
tags in text to produce multiple references to the same footnote. 

§ <P>The macro format for a $GETDVI request is:<FOOTNOTE>{l\The 
eighth (last) 

argument is not used; it is reserved for future use.) 

<CODE_EXAMPLE> 

$GETDVI [efn],[chan],[devnam],itmlst,[iosb],[astadr],[astprm] 

<ENDCODE_EXAMPLE> 

<P>The high-level language format for a $GETDVI request is:<FOOTREF>(1) 

<CODE_EXAMPLE> 

SYS$GETDVI([efn],[chan],[devnam],itmlst<FOOTREF>(1),[iosb],[astadr],[astprm]) 
<ENDCODE_EXAMPLE> 

This example produces the following output: 

The macro format for a $GETDVI request is:^ 

$GETDVI [efn],[chan],[devnam],itmist,[iosb],[astadr],[astprm] 

The high-level language format for a $GETDVI request is:^ 
SYS$GETDVI([efn],[chan],[devnam],itmist "1,[iosb],[astadr],[astprm]) 


^ The eighth (last) argument is not used; it is reserved for future use. 
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<FOOTNOTE TEXT> 


<FOOTNOTE_TEXT> 

Specifies the text of a footnote in a heading, copyright page, or title page. 

FORMAT 

<FOOTNOTE_TEXT>fcftaf 1 text) 

ARGUMENTS 

char 

Specifies the footnote character. The character can be a single character 
or number, or it can be one of the following keywords denoting special 
characters associated with footnote references: 

DAG (t) 

DDAG ($) 

R(®) 

S(§) 

TM (™) 

text 

Specifies the text associated with the footnote. 

related tags 

• <FOOTNOTE> 

• <FOOTREF> 

• <SPECIAL_CHAE> 

restrictions 

Do not use the <F00TN0TE_TEXT> tag for table footnotes; use the 
<FOOTNOTE> tag. 

Must follow the related <FOOTREF> tag in the source file. 

You must use the <SPEC]lAL_CHAR> tag to output a special character that 
you want to appear in the text argument to the <FOOTNOTE_TEXT> tag. 

DESCRIPTION 

The <FOOTNOTE_TEXT> tag specifies the text of a footnote in a heading, 
copyright page, or title page. The footnote text appears at the bottom of 
the page or in a pop-up window for Bookreader output. The <FOOTNOTE_ 
TEXT> tag must follow the <footref> tag. 

Use the <FOOTREF> tag to output a footnote in the argument to a <HEADn> 
tag and the <COMMAND_SECTION_HEAD> and <SUBCOMMAND_SECTION_HEAD> 
tags of the SOFTWARE doctype, and to output footnotes on a copyright 
page or a title page. In all other cases, you must use the <FOOTNOTE> tag. 
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EXAMPLES The following example shows how you might use a footnote on the title 

page of a document. 

Q <FRONT_MATTER> 

<TITLE_PAGE> 

<TITLE>(Guide to Growing Premium Fruit Bearing Plants) 

<ABSTRACT>(July 1990) 

This document describes how to cultivate LEMON<FOOTREF>(TM) trees. 

<ENDABSTRACT> 

<FOOTNOTE_TEXT>(TM\LEMON is a trademark of Lemon Growers, Inc.) 

<ENDTITLE_PAGE> 

The following example shows how to use the <FOOTNOTE_TEXT> and 
<FOOTREF> tags in a heading. 

§ <HEAD1>(Introduction to The News Today<footref>(TM)) 

<footnote_text>(TM\The News Today 

is a trademark of the American Television 

Society.) 


This example produces the following output: 


n_n Introduction to The News Today™ 

The following example shows how to use multiple arguments to the 
<FOOTREF> tag and how to use the <SPECIAL_CHAR> tag in footnote text. 

§ <HEAD1>(Using PostScript<FOOTREF>(1\2) Printers\ps_printers) 

<FOOTNOTE_TEXT>(l\PostScript <SPECIAL_CHAR>(TRADEMARK_SYMBOL) is a trademark 
of Adobe Systems, Inc.) 

<FOOTNOTE_TEXT>(2\For more information about Digital's printers . . . ) 


This example produces the following output: 


n.n Using PostScripts*^ Printers 


The News Today is a trademark of the American Television Society. 
^ PostScript ™ is a trademark of Adobe Systems, Inc. 

^ For more information about Digital’s printers ... 
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<FOOTREF> 

Creates a footnote character in a heading, copyright page, or title page. Also 
used to specify a previously defined footnote in text more than once, and 
along with the <footnote> tag, to produce a footnote in a table. 

FORMAT 

<;FOOTREF>('c/7ar-y [\ char-2...[\char-9]]) 

ARGUMENTS 

chaM...9 

Specifies up to nine characters for a footnote. A character can be a single 
character or number, or it can be one of the following keywords denoting 
special characters associated with footnote references: 

DAG (t) 

DDAG ($) 

R(®) 

S(§) 

TM (™) 

In a table, the reference must be to a number or to one of the special 
characters. 

related tags 

• <FOOTNOTE> 

• <FOOTNOTE_TEXT> 

restrictions 

Invalid in the context of a <MATH> tag. 

You can use only one <FOOTREF> tag per heading or your Bookreader 
bookbuild will fail. 

If you want to generate a special character in the context of footnotes, use 
the <FOOTREF> tag. In other contexts, use the <SPECIAL_CHAR> tag, or you 
may encounter Bookreader bookbuilding problems. 

When using this tag in an argument list, you must place the tag at the 
end of the argument you want to footnote; you cannot embed it in text. 
The end of an argument is indicated by a backslash (\) and the end of an 
argument list is indicated by a closing parenthesis ()). 

DESCRIPTION 

The <FOOTREF> tag creates a footnote character in a heading, copyright 
page, or title page. It is also used to specify a previously defined footnote 
in text more than once, and along with the <FOOTNOTE> tag, to produce a 
footnote in a table. 

The <FOOTREF> tag causes as many as nine superscripted characters to 
appear where you place the tag in your file. 


1-106 





<FOOTREF> 


You must use the <FOOTREF> tag: 

• To specify footnotes in the argument to a <HEADn> tag and <COMMAND_ 
SECTION_HEAD> and <SUBCOMMAND_SECTION_HEAD> tags of the 
SOFTWAKE doctype 

• To specify footnotes on a copyright page and title page 

• To specify the same footnote in text more than once 

• To specify a footnote in a table 

To footnote information in a heading, use a combination of two tags: 
<FOOTREF> and <FOOTNOTE_TEXT>. Place the <FOOTREF> tag in the 
argument to the heading to refer to the <FOOTNOTE_TEXT> tag. Place 
the <FOOTNOTE_TEXT> tag on the line directly following the <HEADn> tag. 

For Bookreader output, you can use only one <FOOTREF> tag per heading. 
Also, the character or number that the <FOOTREF> tag produces is a 

hotspot. 

To use a footnote in a table, use a combination of tags: <FOOTNOTE> and 
<FOOTREF>. Define the <FOOTNOTE> tag just after the <TABLE_SETUP> tag. 
Then use the <FOOTREF> tag to label the footnote references within the 
argument to a <TABLE_row> tag; do not define the footnote within a table 
row. The <FOOTREF> tag causes the text of the footnote to appear at the 
bottom of the table for both printed and Bookreader output. For a printed 
document, if the table is longer than a single page, and if the <FOOTREF> 
tag appears multiple times, the footnote text appears at the bottom of the 
table on each page containing the reference. 

If you have a footnote in text that you want to refer to more than once, 
use a <FOOTNOTE> tag directly after the text to label the first occurrence of 
the footnote and the <F00TREF> tag to label the subsequent references to 
that note. The <FOOTREF> tag always refers to the most recent occurrence 
of the <FOOTNOTE> tag that uses the same argument number or character. 

Note; The text formatter does not automatically repeat text footnotes, 
except for multipage tables, if references are output on more 
than one page. You must reenter the footnote for it to appear on 
another page. 


EXAMPLES 


See the examples in the discussion of the <FOOTNOTE> and <FOOTNOTE_ 
TEXT> tags. 
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<FORMAT> 

Enables the <fcmd>, <fparm>, and <fparms> tags to distinguish formatted 
command keywords and parameters. 

FORMAT 

<FORMAT>^('| heading text [ I WIDE] Uj 
'' 1 WIDE 

ARGUMENTS 

heading text 

This is an optional argument. It specifies a heading. 

WIDE 

This is an optional keyword argument. It specifies, for doctypes in which 
the left margin is indented, that the body of the formatted text be extended 
into the margin. 

related tags 

• <FCMD> 

• <FPARM> 

• <FPAKMS> 

restrictions 

Invalid in the context of <EXAMPLE>, <FIGUEE>, <MATH>, and <TABLE> tags. 

required 

terminator 

<ENDFORMAT> 

DESCRIPTION 

The <FORMAT> tag enables the <FCMD>, <FPARM>, and <FPARMS> tags to 
distinguish formatted command keywords and parameters. 

EXAMPLE 

See the examples in the discussion of the <FCMD> tag. 
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<FPARM> 

Specifies a parameter to be formatted following the <fparms> tag, aligned 
under the parameters portion of a keyword/parameters pair. 

FORMAT 

< FPAR M> (parameter^ 

ARGUMENTS 

parameters 

Lists additional command parameters, if any. 

related tags 

• <FCMD> 

• <FORMAT> 

• <FPARMS> 

restrictions 

Valid only in the context of a <FORMAT> tag. 

DESCRIPTION 

The <FPARM> tag specifies a parameter to be formatted following the 
<FPARMS> tag, aligned under the parameters portion of a keyword/ 
parameters pair. 

EXAMPLE 

See the examples in the discussion of the <FCMD> tag. 
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<FPARMS> 

Specifies the parameter portion of a command/parameter pair in a format 
section. 

FORMAT 

<FPARMS> (parameters) 

ARGUMENTS 

parameters 

Lists the command parameters, if any. If there are no parameters, you 
must specify the argument as null: <FPARMS> (). 

related tags 

• <FCMD> 

• <FORMAT> 

• <FPARM> 

restrictions 

Valid only in the context of a <FORMAT> tag. 

DESCRIPTION 

The <FPARMS> tag specifies the parameter portion of a formatted 
command/parameter pair in a format section. 

EXAMPLE 

See the examples in the discussion of the <FCMD> tag. 
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<FRONT MATTER> 


<FRONT_ 

.MATTER> 

Begins the front matter of a book. 

FORMAT 

<¥ROm_MATrER>[(symbol name)] 

ARGUMENTS symbol name 

This is an optional argument. It specifies the term that you assign to the 
front matter. A symbol name argument is required if the front matter is 
part of a bookbuild. 

Symbol names must not exceed 31 characters and must only contain 
alphabetic letters, numbers, or underscores. Do not begin a S 5 mibol name 
with an underscore. 

related tags 

• See the list of tags in the description section. 

required 

terminator 

<ENDFRONT_MATTER> 


DESCRIPTION The <FRONT_MATTER> tag begins the front matter of a book. You must use 

front matter to create a book for Bookreader. The following tags are used 
to create the front matter: 

• <ABSTRACT> 

• <CONTENTS_FILE> 

• <COPYRIGHT_DATE> 

• <COPYRIGHT_PAGE> 

• <FRONT_MATTER> 

• <ORDER_NUMBER> 

• <PREFACE> 

• <PREFACE_SECTION> 

• <PRINT_DATE> 

• <REVISION_INFO> 

• <TITLE> 

• <TITLE_PAGE> 
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EXAMPLE The following example shows the order of all the front matter tags and 

how you can use them in a file that contains the front matter of a book. 


<FRONT_MATTER>(front) 

<TITLE_PAGE> 

<DEFINE_BOOK_NAME> (using__global_tags\Using Global Tags) 

<TITLE>(<REFERENCE>(using_global_tags)) 

<ORDER_NUMBER>(xx-12345) 

<ABSTRACT> 

This book describes all the global tags. 

<ENDABSTRACT> 

<REVISION_INFO>(Revision/Update Information:\This is a new manual.) 
<ENDTITLE_PAGE> 

<COPYRIGHT_PAGE> 

<PRINT_DATE>{March 1987) 

<COPYRIGHT_DATE>(1987) 

<ENDCOPYRIGHT_PAGE> 

<CONTENTS_FILE> 

<PREFACE>(11) 

<PREFACE_SECTION>(The changes to your system) 

<ENDPREFACE> 

<ENDFRONT MATTER> 
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<GDEF> 

Labels the text that defines a term in a glossary or anywhere in a document. 

FORMAT 

<GDEF> 

ARGUMENTS 

None. 

related tags 

• <GLOSSARY> 

• <GREF> 

• <GTERM> 

DESCRIPTION 

The <GDEF> tag labels the text that defines a term in a glossary or 
anywhere in a document. Use the <GDEF> tag with the <GTERM> tag, 
which labels the term that you want to define. You have the options of 
using the <GLOSSARY> and <ENDGLOSSARY> tags to establish the beginning 
and ending format of a glossary, or simply using the <GTERM> and <GDEF> 
tags to create glossary entries anywhere in your document. 

EXAMPLE 

See the example in the discussion of the <GLOSSARY> tag. 
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<GLOSSARY> 

Formats a glossary of terms in a document or book. 

FORMAT 

<GLOSS ARY > [(text [\symbol name])] 

ARGUMENTS 

text 

This is an optional argument. It specifies any text string you want to 
label the start of the glossary. If you do not specify any text, the default is 
“Glossary.” 

symbol name 

This is an optional argument. It specifies the term that you use to 
reference the glossary. 

Symbol names must not exceed 31 characters and must only contain 
alphabetic letters, numbers, or underscores. Do not begin a symbol name 
with an underscore. 

related tags 

• <GDEF> 

• <GTERM> 

restrictions 

The symbol name argument is required if you include this file in a 
bookbuild. 

required 

terminator 

<ENDGLOSSARY> 

DESCRIPTION 

The <GLOSSARY> tag formats a glossary of terms in a document or book. 
Follow this with a list of <GTERM> tags, with the glossary terms defined 
as arguments to the <GTERM> tags. You must follow the term with the 
definition, which you label with a <GDEF> tag. For a printed book, the 
glossary appears in the table of contents with the beginning page number. 

If you are creating a book for Bookreader, because the entire glossary is 
an online topic, you have the option of displaying in the table of contents 
the beginning and ending glossary term that comprises each online topic 
of information. See VAX DOCUMENT Producing Online and Printed 
Documentation for more information about setting the online topic level 
for a glossary. 
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<GLOSSARY> 


EXAMPLES The following example shows how to use the <GLOSSARY> tags to form a 

separate glossary. 

Q <GLOSSARY\gloss_chap> 

<GTERM>(habitat) 

<GDEF>An area or natural environment. 

<GTERM>(habitual) 

<GDEF>Acting according to habit. 

<GTERM>(hack) 

<GDEF>A worn-out horse. 

<GTERM>(hackneyed) 

<GDEF>Trite, banal. 

<ENDGLOSSARY> 


This example produces the following output: 


Glossary 


habitat: An area or natural environment, 
habitual: Acting according to habit. 


hack: A worn-out horse, 
hackneyed: Trite, banal. 

The following example shows how to code glossary entries that you want 
an3hivhere in your document, rather than in a separate glossary. 

g <GTERM>(habitat) 

<GDEF>(An area or natural environment.) 

<GTERM>(habitual) 

<GDEF>(Acting according to habit.) 

This example produces the following output: 
habitat: An area or natural environment, 
habitual: Acting according to habit. 
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<GREF> 


<GREF> 

Marks a cross-reference to a term within a glossary. 

FORMAT 

<GREF> (glossary term) 

ARGUMENTS 

glossary term 

Specifies the term referred to. 

related tags 

• <GDEF> 

• <GLOSSARY> 

• <GTERM> 

• The following tags label other types of cross-references: 

<REFERENCE> 

<callout_ref> 

restrictions 

Invalid in the context of a <MATH> tag. 

DESCRIPTION 

The <GREF> tag marks a cross-reference from anywhere in your document, 
including the glossary, to a term within a glossary. The glossary term 
argument appears in an italic typeface in some doctypes. 

EXAMPLE 

The following example shows how to use the <GREF> tag to refer to the 
glossary term “cat”. 


<GTERM>(cat) 

<GDEF>(A carnivorous mammal.) 

<GTERM>(cow) 

<GDEF>(The mature female of cattle.) 

<GTERM>(lion) 

<GDEF>(A large <GREF>(cat).) 

This example produces the following output: 
cat: A carnivorous mammal, 
cow: The mature female of cattle, 
lion: A large cat. 
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<GTERM> 


<GTERM> 

Labels a term you want to define in a glossary or anywhere in a document. 

FORMAT 

<GTERM>fter/T7; 

ARGUMENTS 

term 

Specifies the term you want to define in the glossary or anjrwhere in a 
document. 

related tags 

• <GDEF> 

• <GLOSSARY> 

• <GREF> 

required 

terminator 

<GDEF> 

DESCRIPTION 

The <GTERM> tag labels a term you want to define in a glossary or 
anywhere in a document. You must follow the <GTERM> tag with a <GDEF> 
tag, which labels the text that defines the term. To create glossary entries, 
use the <GTERM> and <GDEF> tags in the context of <GLOSSARY> and 
<ENDGLOSSARY> tags. 

EXAMPLE 

See the example in the discussion of the <GLOSSARY> tag. 
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<HEAD> 


<HEAD> 

Creates an unnumbered heading on the left side of the page. 

FORMAT 

<HEAD>('/7eac//ng text [\ symbol name]) 

ARGUMENTS 

heading text 

Specifies the text of the heading. 

symbol name 

This is an optional argument. It specifies the name of the symbol 
used in all references to this heading. Symbol names must not exceed 

31 characters and must only contain alphabetic letters, numbers, or 
underscores. Do not begin a symbol name with an underscore. 

related tags 

• <CHEAD> 

• <CENTER_LINE> 

• <HEADn> 

• <SUBHEADn> 

DESCRIPTION 

The <HEAD> tag creates an unnumbered heading on the left side of the 
page. The heading does not appear in the table of contents. 

EXAMPLE 

The following example shows how to use the <HEAD> tag. 


<HEAD>(How to Write a Letter\how_to) 

<P> 

The first thing that you should do in writing a letter is to get 
a clean piece of paper and a well-sharpened pencil. 

This example produces the following output: 

How to Write a Letter 

The first thing that you should do in writing a letter is to get a clean piece 
of paper and a well-sharpened pencil. 
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<HEADn> 


<HEADn> 

Marks a heading of the level you specify (<headi> through <head6> in all 
doctypes/bold except MILSPEC; in MILSPEC, <headi> through <head 20 >). 

FORMAT 

<HEADn>(heading text[\symbol name]) 

ARGUMENTS 

heading text 

Specifies the text of the heading. If the doctype you are using produces 
headings that are all capital letters in your output, those letters will 
appear that way regardless of how you enter them in your input file. 

You should, however, use uppercase and lowercases letters according to 
your local conventions in order to obtain the proper capitalization of the 
heading in the table of contents and in cross-references. 

symbol name 

This is an optional argument. It specifies the name of the symbol 
used in all references to this heading. Symbol names must not exceed 

31 characters and must only contain alphabetic letters, numbers, or 
underscores. Do not begin a symbol name with an underscore. 

related tags 

• <CHEAD> 

• <HEAD> 

• <SUBHEAD1> 

• <SUBHEAD2> 

restrictions 

Invalid in the context of a <FOOTNOTE> tag. 

You must use the symbol name argument when processing a heading for 
Bookreader display. 


DESCRIPTION The <HEADn> tag marks a heading of the level you specify (<HEADl> 

through <HEAD6> in all doctypes! hold except MILSPEC; in MILSPEC, 
<HEADl> through <HEAD20>). Each of the six heading tags does the 
following: 

• Outputs the heading text supplied by its first argument 

• Automatically numbers the heading 

• Resets all the counters for lower heading levels (if any) 

• Specifies the symbol name with which cross-references to that heading 
are made 

Entries for each of the headings may appear in the table of contents, 
depending on the doctype. 
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<HEADn> 


The proper choice of the heading level depends on an understanding of 
the logical structure of the document you are writing. A <HEAD2> tag will 
always be logically subordinate to a <HEAD1> tag. The same is true for the 
relationship between <HEAD3> and <HEAD2> tags, <HEAD4> and <HEAD3> 
tags, and so on. 

Note: If you use the <HEADn> tag in a preface, the headings are output 
without numbers. You can refer to the headings from other parts 
of your document. The headings, however, do not appear in the 
table of contents. 

DOCUMENT considers each first-level heading to be an online topic. See 
VAX DOCUMENT Producing Online and Printed Documentation for more 
information about online topics. 


EXAMPLES The following <HEAD1> tag labels a first-level heading. 

Q <HEAD1>(Running Tasks\tasks) 

<P>This section explains how the running tasks . . . 

The following <HEAD2> tag labels a second-level heading. 

§ <HEAD2>(More Running Tasks\more_tasks) 

<P>This section explains more specifically how . . . 

The following <HEAD3> tag labels a third-level heading. 

§ <HEAD3>(Final Running Tasks\final_tasks) 

<P>This section explains the final running . . . 

Examples 1, 2, and 3, shown together for comparison, produce the 
following output: 


1.1 Running Tasks 


This section explains how the running tasks . . . 


1.2.1 Specific Running Tasks 

This section explains more specifically how . .. 


1.2.1.1 Final Running Tasks 

This section explains the final running . . . 
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<HEADn> 


You could make a cross-reference to the second heading, for example, by 
using the <REFERENCE>(more_tasks) tag. Because that heading is the 
second level of the first section in the document, the reference would be 
output as Section 1.2.1. 

To control the output of the reference, use one of the formats listed in the 
following table: 


Reference 

Output 

<REFERENCE>(tasks) 

Section 1.2 

<REFERENCE>(tasks\ value) 

1.2 

<REFERENCE>(tasks\text) 

Running Tasks 

<REFERENCE>(tasks\full) 

Section 1.2, Running Tasks 






<HELLIPSIS> 


<HELLIPSIS> 

Places horizontal ellipsis points on a line. 

FORMAT 

<HELLIPSIS> 

ARGUMENTS 

None. 

related tags 

• <ELLIPSIS> 

restrictions 

Invalid in the context of a <MATH> tag. 

DESCRIPTION 

The <HELLIPSIS> tag places horizontal ellipsis points on a line. Often, it is 
used to label omitted material. 

EXAMPLE 

The following example shows how to use the <HELLIPSIS> tag. 


<P>A horizontal ellipsis may provide an indefinite ending <HELLIPSIS> 

This example produces the following output: 

A horizontal ellipsis may provide an indefinite ending . . . 







<HYPHENATE> 


<HYPHENATE> 

Provides information about legal hyphenation of a word. 

FORMAT 

<HYPHENATE>fpartr 1 pan2[\part3...[\partQ]]) 

ARGUMENTS 

part1...part9 

Specifies the word of text and up to nine valid hyphenation points. Each 
argument to the tag specifies a portion of the word. Use the backslash to 
indicate the hyphenation points. 

related tags 

• <final_cleanup>(LINE_BREAK) 

• <KEEP> 

• <LINE> 

restrictions 

Invalid in the context of a <MATH> and an <EXAMPLE> tag. 

DESCRIPTION 

The <HYPHENATE> tag provides information about legal hyphenation of a 
word. This tag does not force a term to be hyphenated; it merely provides 
the text formatter with information about legal places to hyphenate the 
word. 

Use the <HYPHENATE> tag when you are not satisfied with line breaks 
within paragraphs in your final output, and you determine that the line 
breaks are caused because a word is not being hyphenated. This tag is 
also useful when a word or term (usually a technical term that is not 
commonly used) is not being hyphenated correctly. 

EXAMPLE 

The following example shows how to use the <HYPHENATE> tag. 


<p>Among the more common literary devices used are 
<hyphenate>{on\o\mat\o\poe\ia) and anthropomorphism. 


This example produces the following output: 

Among the more common literary devices used are onomato¬ 
poeia and anthropomorphism. 
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<ICON> 


<ICON> 

Allows you to print a small graphic with explanatory text printed to the right or 
left of the graphic. 

FORMAT 

<ICON> 

ARGUMENTS 

None. 

related tags 

• <FIGURE_FILE> 


• <ICON_FILE> 


• <ICON_TEXT> 

restrictions 

Use the <IC0N> tag for graphics that have a length and width of 
approximately 2 inches. Use the <FIGUEE_FILE> tag for larger graphics. 


The output device must support graphics. 

required 

terminator 

<ENDICON> 

DESCRIPTION 

The <IC0N> tag allows you to print a small graphic with explanatory text 
printed to the right or left of the graphic. 


EXAMPLES The following example shows how to code a graphic on the right, with text 

on the left. 


Q <ICON> 

<ICON_FILE>(LN03\small_art.six\l.5\2.0\RIGHT) 

<ICON_TEXT>(The text accompanying the 
small piece of art. The text can be smaller or larger 
than the graphic; the <tag>(ICON) tags make the necessary 
adjustments for the output.) 

<ENDICON> 


1-124 







<ICON> 


The following example shows one graphic placed on the left, with text on 
the right, followed by a second graphic placed on the right, with text on 
the left. 


g <ICON> 

<ICON_FILE>(LN03\RUNNING_SHOES.SIX\13\6) 

<ICON_FILE>(PS\RUNNING_SHOES.PS\13\6) 

<ICON_FILE>(LINE\RUNNING_SHOES\13\6) 

<ICON_FILE>(BOOKREADER\RUNNING_SHOES.BRF\13\6) 

<ICON_TEXT>(The image at the left is of a typical pair of running shoes, 
shown here to illustrate the placement of an icon with text on the right.) 
<ENDICON> 

<ICON> 

<ICON_FILE>(LN03\FORKLIFT.SIX\10\14\RIGHT) 

<ICON_FILE>(PS\FORKLIFT.PS\10\14\RIGHT) 

<ICON_FILE>(LINE\FORKLIFT\10\14\RIGHT) 

<ICON_FILE>(BOOKREADER\FORKLIFT.BRF\10\14\RIGHT) 

<ICON_TEXT>(The image at the right is of a forklift, shown here to illustrate 
the placement of an icon with text on the left.) 

<ENDICON> 


This example produces the following output: 

The image at the left is of a typical pair of running shoes, 
shown here to illustrate the placement of an icon with text 
on the right. 


The image at the right is of a forklift, 
shown here to illustrate the placement 
of an icon with text on the left. 


ZK-9558-GE 




running 
a program 

ZK-9557-GE 
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<ICON> 


The following example shows a graphic placed on the right, with wrapping 
text on the left. 


<ICON> 

<ICON_FILE>(LN03\TEXT_PAGE.SIX\11\7.5\RIGHT) 
<ICON_FILE>(PS\TEXT_PAGE.PS\11\7.5\RIGHT) 
<ICON_FILE>(LINE\TEXT_PAGE\11\7.5\RIGHT) 

<ICON FILE>(BOOKREADER\TEXT PAGE.BRF\11\7.5\RIGHT) 


<ICON_TEXT>(The image at 
wrapping text. The image 
wrapping text, 
wrapping text, 
wrapping text, 
wrapping text, 
wrapping text, 
wrapping text, 
wrapping text, 
wrapping text, 
wrapping text, 
wrapping text.\WRAP) 
<ENDICON> 


The image 
The image 
The image 
The image 
The image at the 
The image at the 
The image at the 
The image at the 
The image at the 


the right is 
at the right 
at the 
at the 
at the 
at the 


right 

right 

right 

right 

right 

right 

right 

right 

right 


a page of text, shown here to illustrate 
is page of text, shown here to illustrate 
is a page of text, shown here to illustrate 
shown here to illustrate 
shown here to illustrate 
shown here to illustrate 
shown here to illustrate 
shown here to illustrate 
shown here to illustrate 
shown here to illustrate 
shown here to illustrate 


page of text, 
page of text, 
page of text, 
page of text, 
of text, 
of text, 
of text, 
of text. 


page 

page 

page 

page 


This example produces the following output: 

The image at the right is a page of text, shown here — ■ ■ " ■■■■ 

to illustrate wrapping text. The image at the right 

is a page of text, shown here to illustrate wrapping ... 

text. The image at the right is a page of text, shown — 

here to illustrate wrapping text. The image at the .— . 

right is a page of text, shown here to illustrate 
wrapping text. The image at the right is a page of 

text, shown here to illustrate wrapping text. The - 

image at the right is a page of text, shown here to - 

illustrate wrapping text. The image at the right is a -- 

page of text, shown here to illustrate wrapping text. ZK-9741-GE 

The image at the right is a page of text, shown here 
to illustrate wrapping text. The image at the right is a page of text, shown 
here to illustrate wrapping text. The image at the right is a page of text, 
shown here to illustrate wrapping text. The image at the right is a page of 
text, shown here to illustrate wrapping text. 
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cICON FILE> 


<ICON FILE> 


Specifies a graphics file that accompanies text within the <icon> and 
<ENDicoN> tags. 


FORMAT 


<\CON_F\LE> (target device { 

1 vertical size 
1 horizontal size 
[\ RIGHT]) 


ARGUMENTS target device 

Specifies a keyword indicating the output device for the graphics 
file. Keywords are provided both for devices that do (LN03, PS, and 
Bookreader) and do not (LINE, MAIL, and TERMINAL) support graphics. 
Each keyword allows you to insert the necessary amount of white space 
for the specific output device; keywords for devices that do not support 
graphics allow you to insert blank space in place of an icon. The following 
table lists the output devices and expected output for each keyword. 


Keyword 

Device 

Output 

BOOKREADER 

DECwindows screen 

The specified graphics file is output 
online using Bookreader. 

LN03 

LN03 Laser Printer 

The specified sixel graphics file is 
output as an icon. 

PS 

PrintServer 40 or 

LN03R ScriptPrinter 

The specified PostScript graphics 
file^ is output as an icon. 

LINE 

MAIL 

TERMINAL 

Line Printer 

If specified, blank space is output 
with the file spec argument written 
in that blank space. Use only one 
of these three keywords to indicate 
a monospaced destination. 

^ PostScript graphics files must conform to the Encapsulated PostScript File Format 
published by Adobe Systems, Inc. 


file spec 

Specifies the graphics file. No default file type is supplied. 

SPACE 

This keyword lets you reserve blank space in the output file for an icon. 
You can use it if you do not use the file spec argument. Use SPACE to 
reserve space for art that will be pasted in at a later date, or when you 
expect to process a file for more than one output device, but do not have 
graphics files for all devices. 
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<ICON FILE> 


related tags 


restrictions 


DESCRIPTION 


EXAMPLE 


vertical size 

Specifies the vertical size of the printed graphic in picas (there are 6 picas 
in an inch and 12 points in a pica). This argument must be a nonnegative 
integer or decimal number, including zero. 

horizontal size 

Specifies the width of the printed graphic in picas (there are 6 picas to 
an inch and 12 points in a pica). This argument must be a nonnegative 
integer or decimal number, including zero. 

RIGHT 

This is an optional ke 3 rword argument. If you use it, it must come last 
in the argument list. RIGHT specifies that the graphic image be placed 
to the right of the text. If you do not specify this argument, the image is 
placed on the left of the text specified in the <IC0N_TEXT> tag. 


• <FIGUKE_FILE> 

• <ICON> 

• <ICON_TEXT> 


Valid only in the context of an <IC0N> tag. 
The output device must support graphics. 


The <ICON_FILE> tag specifies a graphics file that accompanies text within 
the <ICON> and <ENDIC0N> tags. The specified file should be a graphics file 
suitable for printing on the specified output device. 

If you plan to process your file for more than a single destination, you 
can use multiple <IC0N_FILE> tags to ensure that the appropriate icon will 
be included for the appropriate destination. An example of this coding is 
provided in the examples in the <IC0N> tag description. If you use multiple 
<ICON_FILE> tags in this way, you should specify only a single <ICON_FILE> 
tag for all the monospaced destination keywords (MAIL, TERMINAL, or 
LINE). 


See the examples in the description of the <ICON> tag. 
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<ICON TEXT> 


<ICON_TEXT> 

Labels the text that accompanies a graphic image that you include with the 
<ICON_FILE> tag. 

FORMAT 

<ICON_TEXT>('fexf/'l WRAP]) 

ARGUMENTS 

text 

Specifies the text that accompanies the graphic. The text can be as long as 
you want and can include paragraphs and lists. 

WRAP 

This is an optional keyword argument. It specifies that the text wrap 
around the graphic if the text is longer than the graphic. 

related tags 

• <ICON> 

• <ICON_FILE> 

restrictions 

Valid only in the context of an <IC0N> tag. 

If you use the WRAP argument, the text cannot contain any <LIST> or <P> 
tags. 

DESCRIPTION 

The <IC0N_TEXT> tag labels the text that accompanies a graphic image that 
you include with the <IC0N_FILE> tag. The text appears along the side of 
the icon or wraps around the icon if you specify the WRAP argument and 
the text is long enough. 

Both the <ICON_TEXT> and <IC0N_FILE> tags must occur in the context of 
the <ICON> and <END_ICON> tags. 

EXAMPLE 

See the examples in the description of the <IC0N> tag. 
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<INCLUDE> 


<INCLUDE> 

Specifies the position in a document where you want to include a file for 
processing. 

FORMAT 

<INCLUDE>f//7e spec; 

ARGUMENTS 

file spec 

Specifies the file you want to include. 

If you specify a logical name instead, and the source file is an element of 
a book, you can define the logical name using an <INCLUDES_FILE> tag in 
the profile of the book. If the source file is not an element of a book, or if 
the profile does not contain the <INCLUDES_FILE> tag, be sure to define the 
logical name before processing the file. 

related tags 

• <EXAMPLE_FILE> 

• <TABLE_FILE> 

restrictions 

Invalid in an argument to a tag. 

In a file that contains a book element that you want to process through 
a bookbuild, make sure to place the book element tag (for example, 
<CHAPTER>) as the first tag in the file. Place the <INCLUDE> tag after 
the book element tag. 

DESCRIPTION 

The <INCLUDE> tag specifies the position in a document where you want to 
include a file for processing. 

EXAMPLE 

The following example shows how to include a file that does the following: 

• Contains text that might be repeated multiple times in a source file 

• Is used in more than one document 


<INCLUDE>(doc_local_templates rboilerplate.sdml) 

If you did not use the file specification 

doc_localjtemplates:boilerplate.sdml, but instead used a logical name, 
the logical name could be equated to the file specification by using the 
<INCLUDES_FILE> tag in the profile. See the example in the 
<INCLUDES_FILE> tag description. 







<INCLUDES FILE> 


<INCLUDES. 

_FILE> 

Equates a logical name with a file specification during processing of a profile. 

FORMAT 

<INCLUDES_FILE>f/ogf/ca/ name 1 file spec) 

ARGUMENTS 

logical name 

Specifies the logical name for the included file. (You can use this name as 
the argument to an <INCLUDE> tag.) 

file spec 

Specifies the file specification into which the logical name translates. 

related tags 

• <ELEMENT> 

• <INCLUDE> 

• <PROFILE> 

restrictions 

Valid only in the context of a <PROFILE> tag. 


DESCRIPTION The <INCLUDES_FILE> tag equates a logical name with a file specification 

during processing of a profile. You can place the <INCLUDES_FILE> tag in 
your profile to define a logical name for a file whose contents are included 
in one of your element files. The first argument to this tag is the logical 
name for the included file. (You use this name as the argument to the 
<INCLUDE> tag.) The second argument specifies the actual file specification 
into which the logical name translates. 

You do not need to use the <INCLUDES_FILE> tag if either of the following is 
true: 

• Your element file does not contain any <INCLUDE> tags. 

• The <INCLUDE> tags in your element file have complete file 
specifications as arguments. 

The <INCLUDES_FILE> tags follow the <ELEMENT> tag for which they are 
needed. During a bookbuild, VAX DOCUMENT establishes the logical 
name definition for each <INCLUDES_FILE> tag before it actually reads and 
processes the book element file names in the preceding <ELEMENT> tag. 
The logical name remains defined during the processing of later book 
elements. 

When a book element is processed by itself (when you use the /PROFILE 
qualifier on the command line), VAX DOCUMENT again establishes the 
logical name definitions that were specified by the <INCLUDES_FILE> tag in 
the profile. 
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<INCLUDES FILE> 


EXAMPLE The following example shows how to use the <INCLUDES_FILE> tag to define 

a logical name for the file MY_VERY_LONG_TABLE.SDML, which is 
kept in the directory [mydirectory]. In the book element file ERROR_ 
CHAP.SDML, you include the table with the <lNCLlJDE>(error_msg_tab) tag. 


<PROFILE> 


<ELEMENT>(error_chap.sdml) 

<INCLUDES_FILE>(error_msg_tab\mydisk:[mydirectory]my_very_long_table.sdml) 


<ELEMENT>(tags_chap.sdml) 
<ENDPROFILE> 
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<INDEX FILE> 


<INDEX FILE> 


Specifies the position in a book or document where you want to include an 
index file in the output. 


FORMAT <INDEX_FILE>/f///e spec)] 


ARGUMENTS file spec 

This is an optional argument. It specifies the name of the index file. Use 
this argument if you want to include an index file with a name other than 
the default file name. 

The default file name is file spec_index.jyVl_device. If you specify a file 
type, be sure that the device name matches the destination device you 
specify on the DOCUMENT command line. For example, if you specify 
file spec_index.'DVlJPS, be sure you specify PS as the destination on the 
command line. 


related tags • <contents_file> 

• <PROFILE> 


DESCRIPTION The <INDEX_FILE> tag Specifies the position in a book or document where 

you want to include an index file in the output. This tag does not produce 
an index, but instead indicates placement of the index file. An index file 
is produced when you specify the /INDEX qualifier on the DOCUMENT 
command line. See Appendix A for information about using the /INDEX 
qualifier on the command line. 

Using the <INDEX_FILE> tag is highly recommended (but not required) for 
Bookreader output, because an index is helpful for locating information in 
a book you create for Bookreader. 

It is recommended that you place the <INDEX_FILE> tag in your profile. 
This ensures correct placement of the index in both printed and 
Bookreader output. 

An index file always receives the file type .DVI jdevice, where device is the 
type of output device you specified on the DOCUMENT command line. To 
generate an index from an individual file that contains an <INDEX_FILE> 
tag, specify the /INDEX qualifier on the DOCUMENT command line. 

If you specify the /INDEX qualifier on the DOCUMENT command 
line Mdthout using the <INDEX_FILE> tag in your profile, an index is 
generated separately from your document. For more information on 
generating an index, see VAX DOCUMENT Producing Online and Printed 
Documentation. 
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<INDEX FILE> 


EXAMPLE 


See the index in this manual for a sample index. The <INDEX_FILE> tag is 
placed in the profile file after the last appendix file. See the <PR0FIIJE> tag 
description for an example of an <INDEX_FILE> tag in a profile. 




<INTERACTIVE> 


<INTERACTIVE> 


Begins an example dialog between the user and system and enabies the <s> 
and <u> tags to distinguish system text from user text. 


FORMAT 


<INTER ACTI VE> (code) 

or 


<INTERACTIVE>/( 
interactive code or 


[KEEP] \ [WIDE] 
\ [MAXIMUM]] 

text 


)] 


<ENDINTERACTIVE> 


ARGUMENTS code 

Specifies a code fragment you want to insert into your text. 

If you do not specify this argument, you must use <ENDINTERACTIVE> as 
the terminating tag. 

KEEP 

This is an optional keyword argument. It specifies that the example is 
not to be broken across pages; that is, if the example does not fit on the 
current page, it will be placed on the next page. If the example itself does 
not fit on an entire single page of output, it will be broken anyway. This 
keyword has no effect for Bookreader output. 

WIDE 

This is an optional keyword argument. It specifies that the width of the 
example exceeds the document’s default width for text, and, depending on 
the doctype, is interpreted as follows: 

• If the doctype contains a left margin area that is normally used for 
headings, the example’s width spans that area as well as the normal 
text area. 

• If the document uses a multicolumn format, multicolumn output is 
suspended while the example is processed. The example is output and 
multicolumn output is then restored. 

• Depending on the doctype, this argument provides a range of font sizes 
and font styles for examples. 


1-135 






<INTERACTIVE> 


MAXIMUM 

This is an optional keyword argument. It specifies that the text of the 
code example is adjusted to a smaller point size in order to fit within the 
boundaries of the left and right margins of the page. You can use this 
keyword in conjunction with WIDE to indicate that the example may 
require additional adjustment to fit within the boundaries of the page. You 
should use this keyword with discretion, and it may not be suitable in all 
doctypes. 

Note: You can use the KEEP, WIDE, and MAXIMUM keywords together 
or separately and in any order in the argument list. 


related tags 


• <s> 

• <u> 

• <VALID_BREAK> 


restrictions You cannot use indexing tags (<X> and <Y> tags) in the context of an 

<INTERACTrVE> tag. 

You cannot use tab characters to format interactive examples; use spaces 
instead. 

You cannot use text element tags, such as <P>, <LIST>, or <NOTE>, in the 
context of an <INTERACT]:VE> tag. 


required <ENDINTERACTrVE> — Required if you do not specify an argument to the 

terminator <iNTERACTrvE> tag. 


DESCRIPTION The <INTERACTIVE> tag begins an example dialog between the user and 

system and enables the <S> and <U> tags to distinguish system text from 
user text. If your interactive example is longer than a few lines, use 
the <VALID_BREAK> tag to indicate the acceptable points for a page break 
within that example. 


EXAMPLE This example shows how to use the tags to create an interactive example. 

Note that you should specify whatever space follows the system prompt 
within the <S> tag. 

<P>If you do not specify the full command line, DCL will prompt 
you for the missing information. For example, if you do not specify an 
input file and an output file when you enter the COPY command, you will 
be prompted as follows: 

<INTERACTIVE> 

<S>($ )<U>(COPY) 

<S>($_From; )<U>(INTERACT.SDML) 

<S>($_To: )<U>(NEWFILE.SDML) 

<ENDINTERACTIVE> 


This example produces the following output: 
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<INTERACTIVE> 


If you do not specify the full command line, DCL will prompt you for the 
missing information. For example, if you do not specify an input file and 
an output file when you enter the COPY command, you will be prompted 
as follows: 

$ COPY 

$_From: INTERACT.SDML 

$ To: NEWFILE.SDML 



<KEEP> 


<KEEP> 

Specifies that a string of text should not be broken across a line of output. 

FORMAT 

<KEEP>(text) 

ARGUMENTS 

text 

Specifies the text string you want kept on the same line of output. 

related tags 

• You can use the following tags in conjunction wdth the <KEEP> tag to 
allow you to specify formatting attributes: 

<DEFINE_SYMBOL> 

<EMPHASIS> 

<HYPHENATE> 

DESCRIPTION 

The <KEEP> tag specifies that a string of text should not be broken across 
a line of output. Use this tag to specify a string of text you want kept on 
the same line of output. 


EXAMPLES In the following example, the file specification is specified as an argument 

to the <KEEP> tag so that it wdll not be broken across a line. 


D <p> 

The complete file specification is: <KEEP>(DISK$:[SMITH.TRIPS.EXPENSES3MILEAGE.TXT) 

This example produces the following output: 

The complete file specification is: 
DISK$:[SMITH.TRIPS.EXPENSES]MILEAGE.TXT 

The following example defines a text element symbol name using an en 
dash and specifies that the line should not break between the en dash and 
the 11 when you refer to the symbol. 

§ <define_symbol>(vaxll\<delayed><keep>(vax—11)<enddelayed>) 

You refer to the symbol with the <REFERENCE>(vaxll) tag, which produces 
the following output: 

VAX-11 
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<KEYWORD> 


<KEYWORD> 

Labels a word that you want to distinguish typographically. 

FORMAT 

<KEmORD>(word) 

ARGUMENTS 

word 

Specifies the word you want to distinguish. 

related tags 

• <NEWTERM> 

• <SPECIAL_CHAR> 

• <VARIABLE> 

DESCRIPTION 

The <KEYWORD> tag labels a word that you want to distinguish 
typographically. The default action of the <KEYWORD> tag outputs the 
keyword in boldface. As formatted output, the <KEYWORD> tag may 
appear similar to the <EMPHASIS> tag with the BOLD argument. By using 
separate tags to label different kinds of information, however, you are free 
to change the format of any one kind of information without affecting the 
others. 

What constitutes a keyword is something about which both editor and 
writer must agree. Use the <KEYWORD> tag consistently within a document 
and across a document set. 

EXAMPLE 

The following example shows how to use the <KEYWORD> tag. 


<P>A<KEYWORD>(field) is a set of contiguous bytes in a logical record. 

This example produces the following output: 

A field is a set of contiguous bytes in a logical record. 
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<LANGUAGE> 


<LANGUAGE> 


Causes text that is automatically generated by VAX DOCUMENT (such as 
“Example”, “Figure”, “Table”, and so on) to be output in the language you 
specify. It also causes text to be hyphenated and index entries to be sorted 
according to the rules of the language you specify. 


FORMAT 


<LANGUAGE>('{ 


CANADIAN 

DANISH 

DUTCH 

ENGLISH 

FINNISH 

FRENCH 

GERMAN 

ITALIAN 

NORWEGIAN 

PORTUGUESE 

SPANISH 

SWEDISH 




) 


) 


ARGUMENTS language-x 

Specifies the language. English is the default language. Note that 
CANADIAN specifies the French Canadian language. 


restrictions You can use this tag only once in a file; subsequent occurrences of the tag 

are ignored. 

You must place this tag at the beginning of your file or immediately after 
the <PROFILE> tag in a profile. 


DESCRIPTION The <LANGUAGE> tag causes text that is automatically generated by VAX 

DOCUMENT (such as “Example”, “Figure”, “Table”, and so on) to be 
output in the language you specify. It also causes text to be hyphenated 
and index entries to be sorted according to the rules of the language you 
specify. 

To use the default foreign language text, use the <LANGUAGE> tag with the 
argument of your choice. You can change the default foreign language text 
as follows: 

1 To modify the output for individual use only, copy DOC$STANDAKD_ 
FORMATS:TEX$LANGUAGE_MODULES.TEX into a directory and 
define the logical name DOC$PERSONAL_FORMATS to point to that 
directory. For example: 






<LANGUAGE> 


$ DEFINE DOC$PERSONAL_FORMATS DISKl:[MYDIR] 

To modify the output for all users on the system, copy 
DOC$STANDAKD_FORMATS:TEX$LANGUAGE_MODULES.TEX 
into a directory and define the logical name DOC$LOCAL_FORMATS 
to point to that directory. 

2 Edit this local copy of TEX$LANGUAGE_MODULES.TEX by 

uncommenting the line that inputs the language you want to change. 
In the following example, the line that inputs the Danish language 
file has been uncommented, so that a local copy of TEX$DANISH_ 
MODULE.TEX will be used instead of the default version. 


% \input doc$$dorinats : tex$canadian_module. tex 

\input doc$$dormats:tex$danish_module.tex % enables your Danish changes 
%\input doc$$dormats:tex$dutch_module.tex 

3 The text for the supported languages is contained in the following files. 
Copy the file you wish to change into a local directory and edit the file 
for local language changes. 

TEX$CANADIAN_MODULE.TEX 

TEX$DANISH_MODULE.TEX 

TEX$DUTCH_MODULE.TEX 

TEX$ENGLISH_MODULE.TEX 

TEX$FINNISH_MODULE.TEX 

TEX$FRENCH_MODULE.TEX 

TEX$GERMAN_MODULE.TEX 

TEX$ITALIAN_MODULE.TEX 

TEX$NORWEGIAN_MODULE.TEX 

TEX$PORTUGUESE_MODULE.TEX 

TEX$SPANISH_MODULE.TEX 

TEX$SWEDISH_MODULE.TEX 

4 You can modify any of the text strings by entering new text within the 
braces for a specific macro. 

The hyphenation patterns for the supported languages are contained 
in the file TEX$EXCEPTIONS.TEX. The default version of this file, 
which resides in DOC$STANDARD_FORMATS, is invoked when the text 
formatter begins processing. You can modify the hyphenation of any word 
as follows: 

• To change the hyphenation for individual use only, copy 
DOC$STANDARD_FORMATS:TEX$EXCEPTIONS.TEX into a 
directory, define the logical name DOC$PERSONAL_FORMATS to 
point to that directory, and edit the file. 

• To change the hyphenation for all users on the system, copy 
DOC$STANDARD_FORMATS:TEX$EXCEPTIONS.TEX into a 
directory, define the logical name DOC$LOCAL_FORMATS to point to 
that directory, and edit the file. 
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<LANGUAGE> 


VAX DOCUMENT searches for a copy of TEX$LANGUAGE_ 
MODULES.TEX and TEX$EXCEPTIONS.TEX in the order listed below, 
and uses the first copy of each file that it encounters: 

1 DOC$PERSONAL_FORMATS—for individual use 

2 DOC$LOCAL_FORMATS—for local use 

3 DOC$STANDARD_FORMATS—the default version 


EXAMPLES The following example shows how to code a file using the <LANGUAGE> tag. 

Q <LANGUAGE>(FRENCH) 

<CHAPTER>(Le Tour De France) 

<P> La plus longue course de bicyclettes du monde a lieu en France chaque anne6 au 
deblit de I'ete: c'est le Tour de France. 

The following example is part of the English language section of 
TEX$EXCEPTIONS.TEX, to which you add the hyphenation exception 
in the format shown. 


%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% 
% English 

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% 


\gdef\ENGLexceptions{ 
\hyphenation{ 
as-so-ciate 
as-so-ciates 
dec-li-na-tion 
oblig-a-tory 
} 

} 
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<LE> 

Labels a list element. 

FORMAT 

<LE>[(callout number)] 

ARGUMENTS 

callout number 

This is an optional argument. It sets the callout number identif 3 dng the 
list element. 

related tags 

• <LIST> 

restrictions 

Valid only in the context of a <LIST> tag. 

You can use the callout number argument of the <LE> tag only in the 
context of a <LlST>(CALLOUT) tag. 

DESCRIPTION 

The <LE> tag labels a list element. 


EXAMPLES See the examples in the discussion of the <LIST> tag. 
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<LINE> 


<LINE> 


Specifies that the text that foilows this tag be piaced on a new line of output. 


FORMAT 




INDENT [\ unit number] 

BIGSKIP 

SMALLSKIP 


)] 


ARGUMENTS INDENT 

This is an optional keyword argument. It specifies that the next line or 
block of text be indented from the preceding text. 

unit number 

If you use INDENT, you have the option of specif 3 dng a unit number from 
2 to 9 indicating the number of units that the text is to be indented. The 
default indent is 1 unit. The size of these units is determined separately 
for each doctype. 

BIGSKIP 

SMALLSKIP 

These are optional keyword arguments. They specify that a set amount of 
vertical space precede the element identified as a line or block of text. The 
actual amount of space created is determined by the doctype. 


related tags 


• <CENTER_LINE> 

• <FINAL_CLEANUP> 

• <RIGHT_LINE> 


restrictions invalid in the context of an <EXAMPLE> and a <MATH> tag. 


DESCRIPTION The <LINE> tag specifies that the text that follows this tag be placed on 

a new line of output. The result of using the <LINE> tag differs according 
to whether you use it in the context of a <P> tag, a <TABLE_ROW> tag, or a 
<FORMAT> tag: 

• When you specify the <LINE> tag in the context of a paragraph of text 
or a list element, the <LINE> tag ends the current paragraph or list 
element and then starts a new block of text. By default, the block of 
text is not preceded by any extra vertical space, nor is it indented. 

• When you specify the <LINE> tag in the context of a <TABLE_ROW> or a 
<FORMAT> tag, the <LINE> tag causes the following text to begin on a 
new line of output, but does not modify the current paragraph. 






<LINE> 


Be sure that you want a line break in all formatting cases, including 
Bookreader output. Do not use the <LINE> tag in a paragraph simply to 
cause the text formatter to break a line within the paragraph. Breaking a 
line to override a specific line break is a final formatting instruction; use 
the <FINAL_CLEANUP>(LINE_BREAK) tag for this. 


EXAMPLES The following example shows how to use the <LINE> tag in a list. 

Q <LIST>(NUMBERED) 

<le>ITEM 

<LINE>This item specifies... 

This example produces the following output: 

1 ITEM 

This item specifies . .. 

The following example shows how to use the <LINE> tag to create an 
indented line with a small skip. 


g <P>This is a normal paragraph. 

<line>(INDENT\1\SMALLSKIP) 

This is a block paragraph, indented with a small skip. 

This example produces the following output: 

This is a normal paragraph. 

This is a block paragraph, indented with a small skip. 

The following example shows the misuse of the <LINE> tag for formatting 
within a paragraph. 

§ <P>Elaborate designs are inappropriate for software manuals or for 
any serious or formal books because they do not reflect the 
intention of the writer. The purpose of any book design is<LINE> 
to clarify what the author is conveying, to translate the text 
attractively as print on a page, to communicate the message 
visually in harmony with the ideas. 

Although the correct output may result on a given output device for a 
particular run of a file, the output may also be formatted incorrectly, as 
follows: 

Elaborate designs are inappropriate for software manuals or for any 
serious or formal books because they do not reflect the intention of the 
writer. The purpose of any book design is 

to clarify what the author is conveying, to translate the text attractively 
as print on a page, to communicate the message visually in harmony with 
the ideas. 

The following example shows how to use the <LINE> tag in a three-column 
table. 
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<LINE> 


<TABLE>(Card Reader Errors: Causes and Corrective Actions\cardread_tab) 
<TABLE_ATTRIBUTES>(wide\multipage) 

<TABLE_SETUP >(3\12\21) 

<TABLE_HEADS>(Error\Causes\Corrective Action) 

<TABLE_ROW>(READ CHECK\Card edges torn <LINE> Punch in column 0 
or 81\Remove the faulty card from the output stacker, duplicate the card, place 
it in the input hopper, and press the <EMPHASIS>(RESET\bold) button.) 
<TABLE_ROW_BREAK>(FIRST) 

<TABLE_ROW>(PICK CHECK\Damage to leading edge <LINE> Torn webs 
<LINE> Cards 

stapled together\Remove the card from the input hopper, duplicate 
the faulty card, place the card back in the input 
hopper, and press the <EMPHASIS>(RESET\bold) button.) 

<TABLE_ROW_BREAK>(LAST) 

<TABLE_ROW>(STACK CHECK\Jam in the card track <LINE> Badly mutilated card 
\Correct the jam and/or remove the mutilated card from the output stacker, 
duplicate the card, place it in the input hopper, and press the 
<EMPHASIS>(RESET\bold) button.) 

<TABLE_ROW>(HOPPER CHECK\Input hopper empty <LINE> Output stacker full\Load 
the input hopper. <LINE> Unload the output stacker.) 

<ENDTABLE> 


This example produces the following output: 


Table n-n Card Reader Errors: Causes and Corrective Actions 


Error 

Causes 

Corrective Action 

READ CHECK 

Card edges torn 

Punch in column 0 or 81 

Remove the faulty card from the output stacker, 
duplicate the card, place it in the input hopper, and 
press the RESET button. 

PICK CHECK 

Damage to leading edge 

Torn webs 

Cards stapled together 

Remove the card from the input hopper, duplicate the 
faulty card, place the card back in the input hopper, an( 
press the RESET button. 

STACK CHECK 

Jam in the card track 

Badly mutilated card 

Correct the jam and/or remove the mutilated card from 
the output stacker, duplicate the card, place it in the 
input hopper, and press the RESET button. 

HOPPER CHECK 

Input hopper empty 

Output stacker full 

Load the input hopper. 

Unload the output stacker. 


The following example shows how to use the <LINE> tag in the context of a 
<FORMAT> tag. 

g <FORMAT>(MY COMMAND) 

<FCMD>( ) 

<FPARMS>(one parameter<line>two<line>three) 

<ENDFORMAT> 

This example produces the following output: 


MY COMMAND one parameter 

two 

three 
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<LINE ART> 


Labels a rough sketch produced at the terminal keyboard for draft output, to 
give some idea of what the final figure will look like. 


FORMAT <LmE_ART>[([KEEP] I [WIDE] I [MAXIMUM]])] 


ARGUMENTS KEEP 

This is an optional keyword argument. It specifies that the line art not 
be broken across pages; that is, if the line art does not fit on the current 
page, it will be placed on the next page. If the line art itself does not fit 
on a single page of output, it will be broken an 3 rway. This keyword has no 
effect for Bookreader output. 

WIDE 

This is an optional keyword argument. It specifies that the width of the 
line art exceeds the document’s default width for text. Depending on the 
dioctype, this argument is interpreted as follows: 

• If the doctype contains a left margin area that is normally used for 
headings, the line art’s width spans that area as well as the normal 
text area. 

• If the document uses a multicolumn format, the line art suspends the 
multicolumn output while it is being processed. The line art is then 
output, and then multicolumn output is restored. 

• Depending on the doctype, this argument provides a range of font sizes 
and font styles for line art. 

MAXIMUM 

This is an optional keyword argument. It specifies that the text of the 
code example is adjusted to a smaller point size in order to fit within the 
boundaries of the left and right margins of the page. You can use this 
keyword in conjunction with WIDE to indicate that the example may 
require additional adjustment to fit within the boundaries of the page. You 
should use this ke 3 wvord with discretion, and it may not be suitable in all 
doctypes. 

Note: You can use the KEEP, WIDE, and MAXIMUM keywords together 
or separately and in any order in the argument list. 


related tags • <figure> 

• <valid_breae:> 


required <endline_art> 

terminator 
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<LINE ART> 


DESCRIPTION 


The <LINE_ART> tag labels a rough sketch produced at the terminal 
keyboard for draft output, to give some idea of what the final figure 
will look like. 

Note that the results of keyboard drawing may be adequate for draft 
purposes, but may not be acceptable for laser printer output. 

When you print an informal or formal figure (within which is the line art) 
or process an informal figure for Bookreader display, the figure is indented 
in the same way the regular text is for the particular doctype you are 
using. 


EXAMPLE 


See the first example in the discussion of the <FIGURE> tag. 





<LIST> 


<LIST> 


Begins a list. You specify the type of list by using a keyword argument to the 
tag. 


FORMAT <LIST>f/ceyivord/'l attribute-1 [\attribute-2]]) 


ARGUMENTS 


KEYWORD 

Specifies the type of list. The following ke 3 rwords indicate the type of list. 


ALPHABETIC 

CALLOUT 

NUMBERED 

ROMAN 

SIMPLE 

STACKED 


UNNUMBERED 


The list element identifiers are alphabetic letters. 

The list element identifiers are reverse-print callout numbers 
(on supported output devices), for example 0. 

The list element identifiers are Arabic numerals. 

The list element identifiers are Roman numerals. 

There are no list element identifiers. 

Individual list elements do not have identifiers, but the entire 
list is stacked within the specified set of delimiters (braces, 
brackets, double brackets, single or double vertical rules). 

List element identifiers are special characters. 


ATTRIBUTES 

This is an optional argument. It specifies the attributes of the list element 
keywords. You can specify more than one attribute. 


BRACES 

BRACKETS 

DOUBLE_BRACKETS 

DOUBLE_VERTICAL_RULE 

VERTICAL_RULE 

char 


start-letter 


start-number 


For a STACKED list. Each attribute for a STACKED 
list specifies the delimiter to be used to surround the 
stacked elements. If you do not specify a keyword, 
list elements are stacked without a surrounding 
delimiter. 

For an UNNUMBERED list. Specifies a single 
character or a tag that results in a single printed 
character of output that is used to indicate list 
elements. If you do not specify char, the bullet 
character is used. 

For an ALPHABETIC list. Specifies the alphabetic 
letter to use for the first item in the sequence. 
Subsequent items are automatically incremented. 

For a NUMBERED or ROMAN list. Specifies the 
number to be assigned to the first list element. 
Subsequent list elements are automatically 
incremented. 






<LIST> 


related tags 


restrictions 


required 

terminator 


DESCRIPTION 


UPPERCASE For an ALPHABETIC or ROMAN list. Specifies 

that the list element identifiers (alphabetic letters 
or Roman numerals) be printed in uppercase. 

By default, Alphabetic and Roman list element 
identifiers are printed in lowercase. 


• <ALIGN_AFTER> 

• <ALIGN_CHAR> 

• <LE> 


Valid only in the context of a <P> or a <TABLE> tag. 

You can nest <LIST> tags that use the following keywords: ALPHABETIC, 
NUMBERED, ROMAN, SIMPLE, or UNNUMBERED. (Nesting a list 
means that an element of a list may itself contain the beginning of another 
list.) None of these list types are compatible with the <LIST>(STACKED) tag. 


<ENDLIST> 


The <LIST> tag begins a list. You specify the type of list by using a keyword 
argument to the tag. 

The <LIST>(ALPHABETIC), <LIST>(NUMBERED), and <LIST>(ROMAN) tags 
begin a list whose elements have a particular sequence or priority. 

The <LIST>(SIMPLE) or <LIST>(UNNUMBERED) tags begin a list that has no 
inherent order or priority. Alphabetic lists are useful when nested within 
numbered hsts. Use a numbered list to indicate a particular sequence or 
priority within the list elements. 

The <LIST>(SIMPLE) tag labels a simple list with no enumerator or special 
character preceding each hst element. It terminates the current paragraph 
and indents the list, so that the list is seen as a separate entity from the 
text above and below it. 

The <LIST>(UNNUMBERED) tag labels a list that has no particular order 
or priority within the list element. Normally a bullet is the character 
used before each list element. You can specify another character by using 
it as the second argument to the <LIST>(UNNUMBERED) tag; for example, 
<LIST>(UNNUMBERED\ +). 

Use the <LIST>(STACKED) tag to begin a list whose elements are left-justified 
on successive lines. The block of text can have large braces or brackets 
placed on each side. The block of text is then centered vertically so that it 
aligns with text to the left or right on the same line. The <LIST>(STACKED) 
tag is especially useful for showing syntactic elements with a <FORMAT> 
tag. 
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<LIST> 


EXAMPLES The following is an example of nested lists. The first nested list has no 

particular sequence. The order of the second nested list is reflected in the 
use of the <LIST>{ALPHABETIC) tag. 


Q <LIST>(NUMBERED) 

<LE>Review the document 
<LE>Find out these numbers: 

<LIST>(UNNUMBERED) 

<LE>number of copies 
<LE>department number 
<LE>order number 
<ENDLIST> 

<LE>For revisions of documents not already in the library, have 
the writer rename the file according to its new order number. 

<LE>Open a library for the book if none exists. 

<LIST>(ALPHABETIC) 

<LE>Decide with the writer about timing: 

<LIST>(UNNUMBERED) 

<LE>Must be done before final production. 

<LE>Should not be done until text is stable. 

<ENDLIST> 

<LE>Cooperate with the business department on paperwork. 

<LE>Help writers name new element files correctly. 

<LE>Verify that all files are of the same file type. 

<LE>For a revision, be sure files are renamed with the new file name. 

<ENDLIST> 

<ENDLIST> 

This example produces the following output: 

1 Review the document 

2 Find out these numbers: 

• number of copies 

• department number 

• order number 

3 For revisions of documents not already in the library, have the wniter 
rename the file according to its new order number. 

4 Open a library for the book if none exists. 

a. Decide with the writer about timing: 

• Must be done before final production. 

• Should not be done until text is stable. 

b. Cooperate with the business department on paperwork. 

c. Help writers name new element files correctly. 

d. Verify that all files are of the same file type. 

e. For a revision, be sure files are renamed using the new file name. 


The following is an example of an alphabetic list that begins with the 
letter “e”. 




<LIST> 


<P>Items e and f describe the $GETJPI AST activity: 

<LIST>(ALPHABETICXe) 

<LE>An ACB is constructed for a special kernel AST. 

<LE>When the special kernel mode AST routine executes in the context of 
the target process, the requested information is moved into the system buffer. 
The ACB is then reset to deliver a special kernel mode AST back to the 
requesting process. 

<ENDLIST> 


This example produces the following output: 

Items e and f describe the $GETJPI AST activity: 

e. An ACB is constructed for a special kernel AST. 

f. When the special kernel mode AST routine executes in the context of 
the target process, the requested information is moved into the system 
buffer. The ACB is then reset to deliver a special kernel mode AST 
back to the requesting process. 

The following is an example of a list with callouts. 

<P>At this point, you can log in to the system as the system manager 
by performing the following steps at the console terminal: 

<LIST>(CALLOUT) 

<LE>Press RETURN. 

<LE>In response to the system's request for your user name, type SYSTEM. 

<LE>In response to the system's request for your password, type MANAGER. 

<ENDLIST> 


This example produces the following output: 

At this point, you can log in to the system as the system manager by 
performing the following steps at the console terminal: 

O Press RETURN. 

e In response to the system’s request for your user name, type SYSTEM. 

0 In response to the system’s request for your password, type 
MANAGER. 

The following is an example of a numbered list. 

0 <P>At this point, you can log in to the system as the system manager 
by performing the following steps at the console terminal: 

<LIST>(NUMBERED) 

<LE>Press RETURN. 

<LE>In response to the system's request for your user name, type SYSTEM. 

<LE>In response to the system's request for your password, type MANAGER. 

<ENDLIST> 

This example produces the following output: 

At this point, you can log in to the system as the system manager by 
performing the following steps at the console terminal: 

1 Press RETURN. 

2 In response to the system’s request for your user name, t 5 q)e SYSTEM. 

3 In response to the system’s request for your password, type 
MANAGER. 


1-152 



<LIST> 


The following is an example of a numbered list that begins with the 
number “6”. 

§ <P>Items six and seven describe two main principles of a generic 
markup language: 

<LIST>(NUMBERED\6) 

<LE>Descriptive markup predominates and is distinguished from processing 
instructions. 

<LE>Markup is formally defined for each type of document. 

<ENDLIST> 


This example produces the following output: 

Items six and seven describe two main principles of a generic markup 
language: 

6 Descriptive markup predominates and is distinguished from processing 
instructions. 

7 Markup is formally defined for each type of document. 

The following is an example of a list that begins with the Roman numeral 
“iv”. 

<P>Items six and seven describe two main principles of a generic 
markup language: 

<LIST>(R0MAN\4) 

<LE>Descriptive markup predominates and is distinguished from processing 
instructions. 

<LE>Markup is formally defined for each type of document. 

<ENDLIST> 


This example produces the following output: 

Items six and seven describe two main principles of a generic markup 
language: 

iv Descriptive markup predominates and is distinguished from processing 
instructions. 

V Markup is formally defined for each type of document. 

The following is an example of a simple list. 

<P>The following items are needed: 

<LIST>(SIMPLE) 

<LE>bread 

<LE>milk 

<LE>cheese 

<LE>cereal 

<LE>fruit 

<ENDLIST> 


This example produces the following output: 

The following items are needed: 

bread 

milk 

cheese 

cereal 

fruit 
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<LIST> 


The following is an example of two stacked lists with braces aroimd the list 
elements. The tags are indented to help in visually checking the matching 
of the <LIST>(STACKED) and <ENDLIST> tags. This indentation has no effect 
on the output, however. 


S <p> 

ON <LIST>(stacked\braces) 
<LE>ANYCONDITION 
<LE>ENDFILE(reference) 
<LE>ENDPAGE(reference) 
<LE>FINISH 
<LE>KEY(reference) 
<LE>UNDEFINEDFILE(reference) 
<LE>ERROR 
<LE>FIXEDOVERFLOW 
<LE>OVERFLOW 
<LE>UNDERFLOW 

<LE>VAXCONDITION(expression) 
<LE>ZERODIVIDE 
<ENDLIST> 

<LIST>(stackedXbraces) 
<LE>statement 
<LE>begin-block 
<ENDLIST> 


This example produces the following output: 


r ANYCONDITION 


ON { 


ENDFILE(reference) 

ENDPAGE(reference) 

FINISH 

KEY(reference) 

UNDEFINEDFILE(reference) 

ERROR 

FEXEDOVERFLOW 

OVERFLOW 

UNDERFLOW 


VAXCONDITION(expression) 
( ZERODIVIDE 




{ statement 
begin-block 


} 


The following is an example of nested and stacked lists with brackets. 


S <p> 

OPEN FILE (reference) [TITLE(expression)] 

<P> 

<LIST>(stacked\brackets) 

<LE>[STREAM] <LIST>(stacked\brackets) 

<LE>[INPUT] 

<LE>OUTPUT [LINESIZE] [PRINT [PAGESIZE(integer)] ] 

<ENDLIST> 

<LE>RECORD <LIST>(stacked\brackets) 

<LE>[INPUT] 

<LE>OUTPUT 

<LE>UPDATE 

<ENDLIST> 

<LIST>(stackedXbrackets) 

<LE>DIRECT 
<LE>[SEQ[UENTIAL]] 

<ENDLIST> 

[KEYED] 

<ENDLIST> 


This example produces the following output: 
OPEN FILE (reference) [TITLE(expression)] 



<LIST> 


[STREAM] 


[INPUT] 

OUTPUT [LINESIZE] [PRINT [PAGESIZE(integer)] ] 


RECORD 


■ [INPUT] 
OUTPUT 
. UPDATE 


DIRECT 

[SEQ[UENTIAL]] 


[KEYED] 


The following is an example of stacked lists with braces used within a 
table. The <LIST> tags are indented simply as an aid for visually checking 
the nesting of tags. 


IQ <TABLE> 

<TABLE_SETUP>(2\20) 

<TABLE_HEAD S>(I t ems\Descrip t ion) 

<TABLE_ROW>(<LIST>(stacked\braces) 

<IjE>one 

<LE>two 

<LE>three 

<ENDLIST>\Stacked in a table.) 

<TABLE_ROW>(Another item\<LIST>(stackedXbraces) 

<LE>one 

<LE>two 

<LE>three 

<ENDLIST» 

<TABLE_ROW>(This is the last item\) 

<ENDTABLE> 

This example produces the following output: 


Items 

Description 

1 

Stacked in a table. 

< two > 

t three J 


Another item 

( one 'I 
< two > 
t three J 

This is the last item 



The following is an example of an unnumbered hst. 

<P>To create a system that more closely suits the requirements of 
your site, you can do any of the following: 

<LIST>(UNNUMBERED) 

<LE>Select a default bootstrap command procedure 

<LE>Modify system parameters for special hardware configuration needs or 

special workload requirements 

<LE>Perform other site-specific modifications 

<ENDLIST> 


This example produces the following output: 

To create a system that more closely suits the requirements of your site, 
you can do any of the following: 

• Select a default bootstrap command procedure 

• Modify system parameters for special hardware configuration needs or 
special workload requirements 

• Perform other site-specific modifications 
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<LIST> 


The following is an example of how you can specify a character other than 
a bullet to label each list element. 

m <P>To create a system that more closely suits the requirements of 
your site, you can do any of the following: 

<LIST>(UNNUMBERED\+) 

<LE>Select a default bootstrap command procedure 

<LE>Modify system parameters for special hardware configuration needs or 

special workload requirements 

<LE>Perform other site-specific modifications 

<ENDLIST> 

This example produces the following output: 

To create a system that more closely suits the requirements of your site, 
you can do any of the following: 

+ Select a default bootstrap command procedure 

+ Modify system parameters for special hardware configuration needs or 
special workload requirements 

+ Perform other site-specific modifications 
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<LITERAL> 


<LITERAL> 

Allows you to specify text that contains words in angle brackets that might 
otherwise be interpreted as tags. 

FORMAT 

<LITERAL>f//fera/ text) 
or 

<LITERAL> 
literal text 

■ 

« 


■ 

<ENDLITERAL> 

ARGUMENTS 

literal text 

Specifies the literal text to be output exactly as you code it. 

restrictions 

Do not nest a <LITERAL> tag within another <LITERAL> tag. 

required 

terminator 

<ENDLITERAL> —^Required if you do not specify an argument to the 
<LITERAL> tag. 

DESCRIPTION 

The <LITERAL> tag allows you to specify text that contains words in angle 
brackets that might otherwise be interpreted as tags. 

EXAMPLES 

The following example shows how to use the <LITERAL> and <ENDLITERAL> 
tags. 


Q <P> I have experimented with my own method for noting questionable 
phrases, by placing <LITERAL><NOTE_PROBLEM><ENDLITERAL> near the 
phrase. 


This example produces the following output: 

I have experimented with my own method for noting questionable phrases, 
by placing <NOTE_PROBLEM> near the phrase. 






<LITERAL> 


The following example shows how to use the <LITERAL>(literal text) tag. 

<P> I've experimented with my own method for noting questionable 
phrases, by placing <LITERAL>(<NOTE_PROBLEM>) near the 
phrase. 


This example produces the same output as the first example. 



<LOWERCASE> 


<LOWERCASE> 

Labels text that you want to appear as lowercase in the final output. 

FORMAT 

<LOWERCASE>ffexfj 

ARGUMENTS 

text 

Specifies the text to appear in lowercase. 

related tags 

• <UPPERCASE> 

DESCRIPTION 

The <LOWERCASE> tag labels text that you want to appear as lowercase 
in the final output. In your book, you may have a text element, such as 
a heading, that normally appears in uppercase. For example, in some 
doctypes, first-level headings use all uppercase letters. If you need to 
overcome the default case in one of your tags and ensure that the result in 
the final output appears in lowercase, use this tag. 

EXAMPLE 

The following example shows how to use the <LOWERCASE> tag. Assume 
that the doctype being used causes the <HEAD2> tag to output a heading 
that is in uppercase, no matter what the case of the text passed to it. 


<HEAD2>(HeRe iS aN ExAmPlE oF <LOWERCASE>(lOwErCaSe) tExT) 

The example produces the following output: 

HERE IS AN EXAMPLE OF lowercase TEXT 

The default to uppercase letters causes the heading to be uniformly 
uppercase, with the exception of the text used in the argument to the 
<LOWERCASE> tag. 
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<MARK> 


<MARK> 


Indicates the beginning of new or modified information. 


FORMAT <MARK> 


ARGUMENTS None. 


related tags • <Revision> 

• <UPDATE_RANGE> 


restrictions Valid only in the context of a <REVISION> tag. 

Both the <MARK> and <ENDMARK> tags must be within the code for a 
stacked list (using the <LlST>(stacked) tag) if you want change bars in a 
stacked list. 

<MARK> tags within the arguments to the following tags must be 
terminated within the argument by the <endmark> tag. 

• <APPENDIX>, <CHAPTER>, <EXAMPLE>, <FCMD>, <FIGURE>, <FPARMS>, 
<FOOTNOTE>, <GLOSSARY>, <HEADn>, <REVISION_INFO>, <TABLE>, and 
<TITLE> when used within the context of a <PART_PAGE> tag 

Using <MARK> and <ENDMARK> within the arguments to all these tags, 
(except for <FCMD>, <FPARMS>, <FOOTNOTE>, and <REVISION_INFO>), 
create change bars in the table of contents. 

• The following SOFTWARE doctype tags: <COMMAND>, <COMMAND_ 
SECTION>, <ROUTINE>, <ROUTINE_SECTION>, <STATEMENT>, <STATEMENT_ 
SECTION>, <SUBCOMMAND>, <SUBCOMMAND_SECTION_HEAD>, <SDML_ 
TAG>, and <TAG_SECTION> 


req u i red <endmark> 

terminator 


DESCRIPTION The <MARK> tag indicates the beginning of new or modified information. 

The <MARK> tag, along with the <ENDMARK> tag, must be enabled by 
the <REVISI0N> tag in order to produce vertical bars in the margin 
of the document (and optionally, in the table of contents—see the 
RESTRICTIONS section), as well as in MAIL, TERMINAL, and LINE 
output. 

Make sure to place the <MARK> and <ENDMARK> tags next to the text 
they mark, without preceding or following the text with other tags. The 
text formatter interprets the <MARK> tag based on the last text character 
encountered before the <MARK> tag. 
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<MARK> 


EXAMPLE In the following example, the first paragraph is the original and the second 

paragraph is the modified version that shows how to use the <MAEK> and 
<ENDMAEE> tags. 


<p> 

The following characters are legal in MACRO-11 source programs: 

<LIST>(UNNUMBERED) 

<LE>The letters A through Z. Both upper- and lowercase letters are 
acceptable, although, upon input, lowercase letters are converted to 
uppercase. 

<LE>The digits 0 through 9. 

<LE>The characters period <PARENDCHAR>(.) and dollar sign 
<PARENDCHAR>($). These characters are reserved for use as Digital 
Equipment Corporation system program symbols. 

<ENDLIST> 


<REVISION> 


<P> 

The following characters are legal in MACRO-11 source programs: 

<LIST>(UNNUMBERED) 

<LE>The letters A through Z. Both upper- and lowercase letters are 
acceptable, although, upon input, lowercase letters are converted to 
uppercase. 

<MARK> 

<LE>Characters in the Digital Multinational Character Set (MCS). A chart 
showing the MCS is located in <REFERENCE>(mcs_app), 
with a list of directives that 
support the MCS. 

<ENDMARK> 

<LE>The digits 0 through 9. 

<LE>The characters period <PARENDCHAR>(.) and dollar sign 
<PARENDCHAR>($). These characters are reserved for use as Digital 
Equipment Corporation system program symbols. 

<ENDLIST> 


The output for the original paragraph and the modified paragraph follows: 

The following characters are legal in MACRO-11 source programs: 

• The letters A through Z. Both upper- and lowercase letters are 
acceptable, although, upon input, lowercase letters are converted 
to uppercase. 

• The digits 0 through 9. 

• The characters period (.) and dollar sign ($). These characters are 
reserved for use as Digital Equipment Corporation system program 
symbols. 

The following characters are legal in MACRO-11 source programs: 

• The letters A through Z. Both upper- and lowercase letters are 
acceptable, although, upon input, lowercase letters are converted 
to uppercase. 
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<MARK> 


• Characters in the Digital Multinational Character Set (MCS). A chart 
showing the MCS is located in Appendix A, with a list of directives 
that support the MCS. 

• The digits 0 through 9. 

• The characters period (.) and dollar sign ($). These characters are 
reserved for use as Digital Equipment Corporation system program 
symbols. 
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<MATH> 


<MATH> 


Labels a short mathematical expression or the beginning of an extended 
mathematical example. 


FORMAT <MATH>ff , ,1^ 

' \ DISPLAY/^l symbol name] J 


ARGUMENTS math expression 

Specifies a mathematical expression that you want to include in the text of 
a sentence or paragraph. 

DISPLAY 

This keyword specifies that a mathematical equation or expression that is 
longer than one fine is to be set off from the surrounding text. If you use 
DISPLAY, you must use the <ENDMATH> tag to terminate the display. 

symbol name 

This is an optional argument. It specifies a symbol name by which a 
mathematical equation that is longer than one line is to be referenced. 

If you specify this argument, the equation is assigned a number and the 
number is printed to the right of the equation. 

Symbol names must not exceed 31 characters and must only contain 
alphabetic letters, numbers, or underscores. Do not begin a S 5 mibol name 
with an underscore. 


related tags 


• <CODE_EXAMPLE> 

• <MATH_CHAR> 

• <REFERENCE> 


restrictions You cannot use mathematical examples that are longer than one line in 

the context of a <TABLE> or an <EXAMPLE> tag. 

Invalid in the context of a <HEADn> tag. 

Invalid in the context of a <FOOTNOTE> tag. 

Invalid in the context of a <FORMAT> tag. 

You cannot use tab characters and carriage returns for space in the context 
of a <MATH> tag. 

The set of tags valid within a mathematical expression is limited to those 
listed in the tables in the following DESCRIPTION section. 


required <ENDMATH> —^Required if you specify the DISPLAY argument to the 

terminator <math> tag. 
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<MATH> 


DESCRIPTION The <MATH> tag labels a short mathematical expression or the beginning 

of an extended mathematical example. Within an argument to the <MATH> 
tag or within the bounds of the <MATH>(DISPLAY) .. . <ENDMATH> tags, you 
can specify simple or complex mathematical expressions, according to the 
rules outlined below. The context in which you enter text and tags within 
a mathematical expression is severely restricted. 

In a mathematical expression, all formatting is controlled by the text 
processor. When you use the DISPLAY keyword, the output will be offset 
from the surrounding text, but you do not have any control over its 
positioning. Furthermore, blank spaces and carriage returns are ignored; 
the text processor assumes that all text strings are mathematical variable 
names and makes all decisions regarding the output formatting. 

Parentheses 

Most of the tags valid in math do not accept arguments. Parentheses, 
however, are frequently used in mathematical expressions. You must be 
careful, therefore, to use a space between the tag and the parentheses. For 
example: 

<MATH>(A <minus> {B<PLUS>C)) 

Note; At times, it may be helpful to you to use the <OPAREN> and <CPAREN> 
tags in place of the opening and closing parenthesis in math 
equations. This way, you and the text formatter can determine 
what you mean to be a literal parenthesis as opposed to the 
opening or closing parenthesis of an argument. 


Simple Expressions 


The following tags are used to indicate simple binary operations. In the 
context of a mathematical expression, you can use either the tag name or 
the function’s symbol. 

<TIMES> 

* 

Multiplication 

<PLUS> 

+ 

Addition 

<MINUS> 

- 

Subtraction 

<DIVIDED_BY> 

/ 

Division 

<EQUALS> 

= 

Equality 


For example, the following are equivalent: 


<MATH>(total =A+B-C*D/E) 

<MATH>(total <EQUALS> A <PLUS> B <MINUS> C <TIMES> D <DIVIDED_BY> E) 

Both produce the following output: total = A-{- B — C * D/E 

Note: Using any nonalphanumeric characters (such as, @, #, $, tabs, and 
so on) other than those specified above in the context of math 
may produce unpredictable results, including errors from the text 
formatter. 
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<MATH> 


Operators are evaluated using the normal mathematical rules for 
precedence of operators. You can control the evaluation by using the 
<GROUP> tag, much as you would use parentheses in a mathematical 
expression. Note the use of the <GROUP> tag in the second math expression 
in the following code fragment: 

<MATH>(total = A +B-C*D<OVER>(e) ) 

<P> 

<MATH>(total = <GROUP>(<GROUP>(A +B-C*D)<OVER>(e)) ) 

This example produces the following output: 

total=A+B—C*D 

e 

total = 

The effect of the <GROUP> tag is supplied by default for fractional 
expressions when you use the <FRACTI0N> tag. For example: 

<MATH>(display) 

total = <FRACTION>(A + B - C * D\E) 

<ENDMATH> 

Variable Names 

The text formatter assumes that variable names are primarily alphabetic 
letters or . special characters represented by the <MATH_CHAR> tag. If you 
need to specify any variable names in expressions that contain special 
characters, you must use the <VARIABLE> or <TEXT> tags. For example: 

<MATH>(<variable>(event_flag) = 1) 

If you require multiword variable names, you must use the <SP> tag to 
indicate spacing. For example: 

<MATH>(display) 

<VARIABLE>(SUCCESS<sp>RATE) <equals> 

<group>( 

<VARIABLE>(TOTAL<SP>HITS) <over>(<VARIABLE>(TOTAL<sp>HITS) <plus> 

<VARIABLE>(TOTAL<sp> MISSES) 

) 

) 

<times> 100 
<ENDMATH> 

This example produces the following output: 


SUCCESS RATE = 


TOTAL HITS 

TOTAL HITS + TOTAL MISSES 


* 100 


You can provide special annotation for variable names by using the 
following tags: 


Tag Output 

<BAR_CHAR>(x) z 

<DOT_CHAR>(x) X 

<HAT>(xyz) 

<HAT_CHAR>(x) x 


1-165 





Tag 

Output 

<OVERLINE>(var) 

vaf 

<TILDE>(xyz) 


<TILDE_CHAR>(x) 

X 

<UNDERLINE>(var) 

var 

<VECTOR>(x) 

S 


Summary of Tags 

Table 1-1 summarizes the tags that are valid in mathematical expressions. 


Table 1-1 <MATH> Expressions 


Tag 

Operation and Output 

<AMPERSAND> 

Specifies a literal ampersand character 
in a math expression. 

<ATOP>{expression) 

Stacks an expression, as in ®. 

<BACKSLASH> 

Specifies a literal backslash character 
in a math expression. 

<CAL>(/e/fer) 

Specifies a calligraphic uppercase 
letter, as in A. 

<CASES> 

Specifies a case construction. See 

<CASE ROW> 

“Matrixes and Cases” in this tag 

<ENDCASES> 

description. 

<CDOTS> 

Specifies centered dots, as in • • •. 

<CHOOSE>(express/on 1\ expression2) 

Parenthetical notation, as in ("). 

<DDOTS> 

Specifies diagonal dots, as in 

<DIVIDED_BY> 

Division, as in a/6. 

<DOTS> 

Specifies horizontal dots, as in .... 

<DOT_TIMES> 

Multiplication, as in a • 6. 

<EQUALIGN> 

Starts an alignment section, so that 

<ELINE> 

expressions on the right and left side of 

<ENDEQUALIGN> 

a character (usually an equal sign) are 
balanced. See “Aligning Expressions” 
in this tag description. 

<EQUALS> 

Equality, as in a = 6. 

<FRACTION>(/7umerafor \ denominatoi) 

Specifies a fraction, as in f. 

<f\JHC>{expression) 

Specifies a function, as in /(a). 

<GHO\JP>{expression) 

Provides control over the order of 
operation. See example four in 
the “Examples” section in this tag 
description. 



<MATH> 


Table 1-1 (Cent.) <MATH> Expressions 


Tag 


Operation and Output 


<INTEGRAL> 

<INTEGRAL_LIMITS> 


<INTEGRAL_NOLIMITS> 


<MATRIX> 

<MATRIX_ROW> 

<ENDMATRIX> 

<MINUS> 

<MOD> 

<LBAR> 


<LBRACE> 


<LBRACKET> 


<LCEIL> 


<LFLOOR> 


<LPAREN> 


<0\/ER>{expression) 

<PI> 

<PLUS> 

<PMOD>{expression) 

<PROD> 


Specifies an integral, as in . See 
“Operators With and Without Limits” in 
this tag description. 

Specifies an integral that places 
superscripts and subscripts above and 
below the sign, rather than to the right. 
See “Operators With and Without 
Limits” in this tag description. 

Specifies an integral that places 
superscripts and subscripts to the 
right of the sign, rather than above 
and below. See “Operators With and 
Without Limits” in this tag description. 

Specifies a matrix. See “Matrixes and 
Cases” in this tag description. 

Minus, as in a - b. 

Modulo, as in n mod p. 

Begins an expression delimited 
with vertical bars. See “Delimited 
Expressions” in this tag description. 

Begins an expression delimited 
with curly braces. See “Delimited 
Expressions” in this tag description. 

Begins an expression delimited with 
square brackets. See “Delimited 
Expressions” in this tag description. 

Begins an expression delimited with 
ceiling characters ([). See “Delimited 
Expressions” in this tag description. 

Begins an expression delimited with 
floor characters ([). See “Delimited 
Expressions” in this tag description. 

Begins an expression delimited 
with parentheses. See “Delimited 
Expressions” in this tag description. 

Division, as in |. 

The pi character, tt. 

Plus, as in a + b. 

Parenthetical mod, as in a (mod p). 

Specifies a product, as in fjjf . See 
“Operators With and Without Limits” in 
this tag description. 
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Table 1-1 (Cont.) <MATH> Expressions 


Tag 


Operation and Output 


<PROD LIMITS> 


<PROD_NOLIMITS> 


<RBAR> 

<RBRACE> 

<RBRACKET> 

<RCEIL> 

<RFLOOR> 

<RPAREN> 


<SP> 

<SQRT>{expressiori) 

<SUBSCRIPT>(express/on) 

<SUM> 


<SUM LIMITS> 


<SUM_NOLIMITS> 


Specifies a product that places 
superscripts and subscripts above 
and below the sign, rather than to 
the right. See “Operators With and 
Without Limits” in this tag description. 

Specifies a product that places 
superscripts and subscripts to the 
right of the sign, rather than above 
and below. See “Operators With and 
Without Limits” in this tag description. 

Ends an expression delimited 
with vertical bars. See “Delimited 
Expressions” in this tag description. 

Ends an expression delimited with curly 
braces. See “Delimited Expressions” 
in this tag description. 

Ends an expression delimited with 
square brackets. See “Delimited 
Expressions” in this tag description. 

Ends an expression delimited with 
ceiling characters (]). See “Delimited 
Expressions” in this tag description. 

Ends an expression delimited with 
floor characters (J). See “Delimited 
Expressions” in this tag description. 

Ends an expression delimited 
with parentheses. See “Delimited 
Expressions” in this tag description. 

Provides space in a variable name or 
expression. 

The square root, as in y/a. 

Subscription, as in ab- 

Specifies summation, as in aj^b. See 
“Operators With and Without Limits” in 
this tag description. 

Specifies summation that places 
superscripts and subscripts above and 
below the sign, rather than to the right. 
See “Operators With and Without 
Limits” in this tag description. 

Specifies summation that places 
superscripts and subscripts to the 
right of the sign, rather than above 
and below. See “Operators With and 
Without Limits” in this tag description. 



<MATH> 


Table 1-1 (Cent.) <MATH> Expressions 


Tag 

Operation and Output 

<S U P E RSCR1 Pl>{expression) 

Exponentiation, as in a*. See 
“Operators With and Without Limits” in 
this tag description. 

<TEXT> 

Specifies text in a math expression. 

<TIMES> 

Multiplication, as in a * h. 

<TO> 

Indicates progression, as in l 10. 

<VARIABLE> 

Specifies a variable name that contains 
nonalphanumeric characters. 

<VDOTS> 

Specifies vertical dots, as in :. 

<VECTOR>(i^a/) 

A vector, as in x. 

<X_TIMES> 

Multiplication, as in a x b. 


Operators With and Without Limits 

When you specify <SUBSCRrPT> and <SUPERSCRIPT> tags, the subscript or 
superscript appHes to the immediately preceding variable or expression. 
You can specify these tags in any order, as shown in the following example: 

<MATH>(a<subscript>(2)<superscript>(n-1)) 

This example produces the following output: 

In extended mathematical expressions, the <SUPERSCR1PT> and 
<SUBSCRIPT> tags produce differing results in conjunction with the 
<INTEGRAL>, <PROD>, and <SUM> tags and their complementary tags- 
<INTEGRAL_LIMITS> and <INTEGRAL_NOLIMITS>, <PROD_LIMITS> and <PROD_ 
NOLIMITS>, and <SUM_LIMITS> and <SUM_NOLIMITS>. 

The <INTEGRAL>, <PROD>, and <SUM> tags place their subscripts and 
superscripts with regard to whether the tags are used in math text mode 
(used as an argument to the <MATH> tag) or in math display mode (used 
between the <math>(DISPLAY) and <ENDMATH> tags). 

In math text mode, the <INTEGRAL>, <PROD>, and <SUM> tags all place the 
superscript and subscript to the right. Code these tags as follows: 

<MATH>(<integral><subscript>(n=l)<superscript>( <pi><over>(2) ) <sp> ) 
<MATH>( <procl><subscript> (n=l) <superscript> ( <pi><over>(2) ) <sp> ) 
<math>( <sum><subscript>{n=l)<superscript>( <pi><over>(2) ) ) 

S. 2L S. 

This example produces the following output: Ilnsi Yln=i 

In math display mode, the <PROD> and <SUM> tags place the superscript 
and subscript above and below their respective signs; however, the 
<INTEGRAL> tag places superscripts and subscripts to the right. Code 
these tags as follows: 

<MATH>(display) 

<integral><subscript>(n=l)<superscript>( <pi><over>(2) ) <sp> 
<prod><subscript><n=l)<superscript>( <pi><over>(2) ) <sp> 
<sum><subscript>(n=l)<superscript>( <pi><over>(2) ) 

<ENDMATH> 
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This example produces the following output: 



The <INTEGRAL_NOLIMITS>, <PROD_NOLIMITS>, and <SUM_NOLIMITS> tags 
always place the subscripts and superscripts to the right of the signs, 
regardless of the math mode. Code these tags as follows: 

<MATH>(display) 

<integral_nolimits><subscript>(n=l)<superscript>( <pi><over>(2) ) <sp> 
<prod_nolimits><subscript>{n=l)<superscript>( <pi><over>(2) ) <sp> 
<sum_nolimits><subscript>(n=l)<superscript>( <pi><over>(2) ) 
<ENDMATH> 

This example produces the following output: 



The <INTEGRAL_LIMITS>, <PR0D_LIMITS>, and <SUM_LIMITS> tags always 
place the subscripts and superscripts above and below the signs, regardless 
of the math mode. Code these tags as follows: 

<MATH>(display) 

<integral_limits><subscript>(n=l)<superscript>( <pi><over>(2) ) <sp> 
<prod_limits><subscript>(n=l)<superscript>( <pi><over>(2) ) <sp> 
<sum_limits><subscript>(n=l)<superscript>( <pi><over>(2) ) 

<ENDMATH> 

This example produces the following output: 



Mathematical Functions 

In addition to the operations and special functions listed in Table 1—1, 
you can specify mathematical functions using any of the tags listed in 
Table 1—2. These tags all let you specify the tag with or without an 
argument. If you specify an argument, place it in parentheses following 
the function name. For example: 

<MATH>(<SIN>(d)) 

This produces: sin(cl!). 



<MATH> 


Table 1-2 Tags for Mathematical Functions 


Tag 

Function 

<ARCCOS> 

arccos 

<ARCSIN> 

arcsin 

<ARCTAN> 

arctan 

<ARG> 

arg 

<COS> 

cos 

<COSH> 

cosh 

<COT> 

cot 

<COTH> 

coth 

<CSC> 

CSC 

<DEG> 

deg 

<DET> 

det 

<DIM> 

dim 

<EXP> 

exp 

<GCD> 

gcd 

<HOM> 

horn 

<INF> 

inf 

<KER> 

ker 

<LG> 

Ig 

<LIM> 

lim 

<LIMINF> 

lim inf 

<LIMSUP> 

lim sup 

<LN> 

In 

<LOG> 

log 

<MAX> 

max 

<MIN> 

min 

<MOD> 

mod 

<PMOD> 

(mod »)’ 

<PR> 

Pr 

<SEC> 

sec 

<SIN> 

sin 

<SINH> 

sink 

<SUP> 

sup 

<TAN> 

tan 

<TANH> 

tanh 

’ Using the <PMOD> tag adds a space before the output of the tag, which is why the 
output of the tag is not aligned in the “Function” column of this table. 


An example of using some of the tags from the previous table follows: 
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<LIST>(UNNUMBERED) 

<le><niath> ( 

<sin>2<math_char>(theta) 

<equals>2<sin><math_char>(theta)<cos><math_char>(theta) 

) 

<le><math>( 

0(n <log>n <log><log>n) 

) 

<le><math>( 

<pr>(X >x)= <exp>(-x/<raath_char>(mu)) 

) 

<le><math>( 

<max><subscript>(l<math_char>(geq)n<math_char>(geq)m) 

<log><subscript>(2)P<subscript>(n) 

) 

<le><math>( 

<lim><subscript>(x<to>0)<group>( 

<sin>x<over>(x)) 

<equals>l 

) 

<endmath> 

<ENDLIST> 

These examples produce the following output: 

• sin 2^ = 2 sin ^ cos 9 

• 0(n log n log log n) 

• Pr(X > a;) = exp(—a://^) 

• maxi>„>^log2 Pn 

• lim,_o^ = l 

Aligning Expressions 

To align math expressions on the right and left side of an alignment point 
(usually an equal sign) so that the expressions are balanced, use the 
following tags: 

• <EQUALIGN>—^begins an alignment section and enables the <ELINE> tag. 

• <ELINE> —stakes an argument representing the left and right side of the 
equation. The first character in the second argument is the character 
upon which the alignment is based. 

• <ENDEQUALIGN>—^terminates the ahgnment section. 

For example: 

<math> 

<EQALIGN> 

<eline>(H(f)\= 

<GROUP>(<LBAR><GROUP>(<FRACTION>(E(x)\E(0)))<RBAR> 

<SUBSCRIPT>(E(0)=e<SUPERSCRIPT>(j<MATH_CHAR>(OMEGA)t)))) 

<Eline> (\=<GROUP> (e<SUPERSCRIPT> (-'<MATH_CHAR> (GAMMA) x) ) ) 

<endeqalign> 

<ENDMATH> 



<MATH> 


This example produces the following output: 

mn = S 

= e"'^® 

Delimited Expressions 

To produce delimited expressions in mathematics, you must use one of the 
following pairs of tags: 

• <LBAR> and <RBAR>—for opening and closing vertical bars 

• <LBRACE> and <RBRACE> —^for opening and closing curly braces 

• <LBRACKET> and <RBRACKET> —^for opening and closing square brackets 

• <LCEIL> and <RCEIL> —^for opening and closing ceiling delimiters 

• <LFLOOR> and <RFLOOR> —^for opening and closing floor delimiters 

• <LPAREN> and <RPAREN> —^for opening and closing parentheses 

The text formatter automatically assumes that text within these pairs is 
to be grouped, and it sizes the delimiters automatically. 

For example: 

<MATH>(display) 

<group>( 

C<subscript>(dg) 

) = 

<fraction>(<math_char>(partial)Q<subscript>(d)\ 

<math_char>(partial)V<subscript>(g)) 

-C<subscript>(oxt) 

[0.5 

+ 

<lparen>f<subscript>(0) DVG 

<group>(2f<subscript>(0) V<subscript>(com)<over>(f<subscript> (1)) 
) 

<rparen> 

<group>(l <over>(f<subscript>(1)<superscript>(2))) 

] 

<ENDMATH> 

This example produces the following output: 
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<MATH> 


Matrixes and Cases 

You can construct matrixes and case constructs using the formats provided 
with <MATRIX> and <CASES> tags. 


The <MATRIX> tag has the following format: 


<MATRIX>( 


BRACES 

BRACKETS ) 

. VERTICAL_RULE . 


The keywords BRACES, BRACKETS, and VERTICAL_RULE override the 
default matrix dehmiter, parentheses. 


When you construct a matrix, you must specify each row in the matrix 
using the <MATRIX_R0W> tag. You can specify a maximum of nine columns 
for the row. Terminate the matrix with the <ENDMATRIX> tag. For example: 


<matrix>(brackets) 

<matrix_row>(A) 

<matrix_^row> (B) 

<matrix_row>(C) 

<matrix_row>(D) 

<endmatrix> 

This simple, one-column matrix produces the following output: 


A- 

B 

C 

.D. 


A more complex example shows how to code a multicolumn matrix: 

<math>(display) 

<det><matrix>(vertical_rule) 

<matrix_row>(c<subscript>(0)\c<subscript>(1)\ 

c<subscript>(2)\<dots>\c<subscript>(n)) 

<matrix_row>(c<subscript>(1)\c<subscript>(2)\ 

c<subscript>(3)\<dots>\c<subscript> (n+1)) 
<matrix_row>(c<subscript>(2)\c<subscript>(3)\ 

c<subscript>(4)\<dots>\c<subscript>(n+2)) 

<mat rix_row>(<vdot s>\<vdot s >\<vdots >\<vdot s>) 

<matrix_row>(c<subscript>(n)\c<subscript>(n+1)\ 

c<subscript>(n+2)\<dots>\c<subscript>(2n)) 
<endmatrix> >0. 

<endmath> 

This produces the following output: 



CO 

Cl 

C2 

.. Cn 


Cl 

C2 

C3 

• • c„+i 

det 

C2 

C3 

C4 

> • C„+2 


Cn 

Cn+1 

c»i +2 

•• C2„ 
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<MATH> 


The following example shows how to code a multicolumn matrix wdth 
fractions: 

<inath> (display) 

<matrix>(brackets) 

<matrix_row>(4<over>(4<minus>6)\2<over>(6<minus>4)) 

<matrix_row> (3<over> (6<minus>4) \l<over> (4<ininus>6) ) 

<endmatrix> = 

<matrix>(brackets) 

<matrix_row>(4<over>(<minus>2)\2<over> (2)) 

<matrix_row>(3<over>(2)\l<over>(<minus>2)) 

<endmatrix> = 

<matrix>(brackets) 

<matrix_row>(<minus>2\<sp>l) 

<matrix_row>(1.5\<minus>.5) 

<endmatrix> 

<endmath> 

This produces the following output: 


'4 2 ■ 


[4 2 1 

P 





3 1 


3 1 

—— 

.5^ 5^. 


L 2 




The <CASES> tag is similar to the <MATRIX> tag, but it produces only a large 
left-hand brace; there is no closing delimiter. The following example shows 
how to use the <CASES> tag and its related tags: 

<MATH>(display) 

<cases> 

<case_row>(l/3\if\0> x\;) 

<case_row>(2/3\if\3< x\;) 

<case_row>(0\elsewhere.) 

<endcases> 

<ENDMATH> 

This example produces the following output: 

ri/3 ifO>a:; 

<2/3 if 3 < re; 

10 elsewhere. 


EXAMPLES The following example illustrates a simple mathematical expression used 

in the context of a sentence. 

Q The area of a circle is calculated using the 

formula <MATH>(a<equals><pi>r<superscript>(2)). 

This example produces the following output: 

The circumference of a circle is calculated using the formula c — Trr^. 

The following example shows how to use the <MATH>(DISPLAY) tag. Note 
that the parenthetical expression following the first <MINUS> tag must 
have a space in front of it; otherwise, the expression wdll be interpreted as 
an argument to the <MINUS> tag. 
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<MATH> 


g <MATH>(DISPLAY) 

vsize <equals> psize <ininus>(<minus>topglue) <minus> topdepth <minus> footerglue 
<ENDMATH> 


This example produces the following output: 

vsizt = "psizt — {—topglue) — topdepth — footerglue 


The following example shows how to use the <MATH> tag in a list. 


gj <LIST>(NUMBERED) 

<le><MATH>(l<over>(2) ) 

<le><MATH>(n+l<over>(3) ) 

<le><MATH>(<choose>(N+l\3)) 

<le><MATH>(<sum><subscript>(n=l)<superscript>(3)Z<subscript>(n)<superscript>(2)) 

<ENDLIST> 

This example produces the following output: 

o n+l 

2 “3” 

3 (Y) 

4 

The following example illustrates how to use the <GROUP> tag to indicate 
the order of operation. 


g <MATH>(DISPLAY) 

<GROUP>( 

a<over>(x<plus>y<superscript>(3)) 

) 

<EQUALS> <SQRT>(<times><pi>) 
<ENDMATH> 


This example produces the following output: 


a 

x->ry^ 


= \/*¥ 


Note what the output would be if you did not use the <GROUP> tag: 

o> 


In the following example, the characters representing the mathematical 
operations are used directly. 

g <MATH>(total =A+B-C*D/E) 

This example produces the following output: 
total = A-\- B — C * D/E. 

Note that this is equivalent to the following: 

<MATH>(total <EQUALS> A <PLUS> B <MINUS> C <TIMES> D <DIVIDED_BY> E) 

The following example shows how to use the <MATH> tag to generate true 
minus signs in your SDML files. 



<MATH> 


^ <MATH>{—)This begins a comment line. 

This example produces the following output: 

—This begins a comment line. 

The following example shows how to use the <REFERENCE> tag to refer to 
an equation. 

g <MATH>(DISPLAY\math_equation) 
math = numbers + letters 
<ENDMATH> 

<p>As <REFERENCE>(math_equation) shows, the relationship between 
letters and math must include numbers. 

This example produces the following output: 

math = numbers + letters (1—1) 


As (1-1) shows, the relationship between letters and math must include 
numbers. 
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<MATH CHAR> 


<MATH_ 

.CHAR> 

Creates a special mathematical symbol. 

FORMAT 

<M ATH_CH AR> (keyword) 

ARGUMENTS keyword 

Indicates the special symbol you want to access. The kejrwords, and the 
symbols they produce, are listed in Table 1-3. 

related tags 

• <MATH> 

• <MCS> 

• <SPECIAL_CHAR> 

restrictions 

Invalid in headings, that is, within an argument to a <HEADn> tag. 

The characters produced using the <MATH_CHAR> tag are sized only for 
normal text sizes. Therefore, these characters do not produce good visual 
results in text that requires a different font size, like header levels, text in 
the OVERHEADS doctype, and so on. 


DESCRIPTION The <MATH_CHAR> tag creates a special mathematical symbol. Table 1-3 

summarizes the ke 3 rwords and special symbols you can access with the 
<MATH_CHAE> tag. 


Table 1-3 <MATH_CHAR> Keywords and Symbols 


Keyword 

Symbol 

The Greek Letters 

ALPHA 

a 

BETA 

P 

CHI 

X 

DELTA 

6 

EPSILON 

e 

ETA 

V 

GAMMA 

7 

IOTA 

i 

KAPPA 

K 

LAMBDA 

A 

MU 

A 
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<MATH CHAR> 


Table 1-3 (Cont.) <MATH_CHAR> Keywords and Symbols 


Keyword 

Symbol 

The Greek Letters 

NU 

u 

OMEGA 

U) 

OMICRON 

0 

PHI 

<!> 

PI 

TT 

PSI 


RHO 

P 

SIGMA 

O’ 

TAU 

T 

THETA 

e 

UPSILON 

V 

VAREPSILON 

e 

VARPHI 

<P 

VARPI 

w 

VARRHO 

Q 

VARSIGMA 

? 

VARTHETA 

& 

XI 

e 

ZETA 

iT 

The Uppercase Greek Letters 

UPPERCASE_ALPHA 

A 

UPPERCASE_BETA 

B 

UPPERCASE_CHI 

X 

UPPERCASE_DELTA 

A 

UPPERCASE_EPSILON 

E 

UPPERCASE_ETA 

H 

UPPERCASE_GAMMA 

r 

UPPERCASEJOTA 

I 

UPPERCASE_KAPPA 

K 

UPPERCASE_LAMBDA 

A 

UPPERCASE_MU 

M 

UPPERCASE_NU 

N 

UPPERCASE_OMEGA 

n 

UPPERCASE_OMICRON 

0 

UPPERCASE_PHI 
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<MATH CHAR> 


Table 1-3 (Cent.) <MATH_CHAR> Keywords and Symbols 


Keyword 

Symbol 

The Uppercase Greek Letters 

UPPERCASE_PI 

n 

UPPERCASE_PSI 


UPPERCASE_RHO 

p 

UPPERCASE_SIGMA 

E 

UPPERCASE_TAU 

T 

UPPERCASE_THETA 

0 

UPPERCASE_UPSILON 

r 

UPPERCASE_X1 

n 

UPPERCASE_ZETA 

z 

The Ordinal Operators 

ALEPH 


ANGLE 

z 

BACKSLASH 

\ 

BOT 


CLUBSUIT 

A 

DIAMONDSUIT 

<> 

DOUBLE VERT 

11 

t 

ELL 

EMPTYSET 

0 

EXISTS 

3 

FLAT 

b 

FORALL 

V 

HBAR 

n 

HEARTSUIT 


IM 

3? 

IMATH 

i 

INFTY 

oo 

JMATH 

3 

NABLA 

V 

NATURAL 

u 

NEG 

“1 

PARTIAL 

d 

PRIME 

1 

RE 


SHARP 

« 
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<MATH CHAR> 


Table 1-3 (Cent.) <MATH_CHAR> Keywords and Symbols 


Keyword 

Symbol 

The Ordinal Operators 

SPADESUIT 

4 

SURD 

v/ 

TOP 

T 

TRIANGLE 

A 

WP 

P 

Binary Operators 

AMALG 

U 

AST 

* 

BIGCIRC 

o 

BIGTRIANGLEDOWN 

V 

BIGTRIANGLEUP 

A 

BULLET 

• 

CAP 

n 

CDOT 


CIRC 

0 

CUP 

U 

DAGGER 

t 

DDAGGER 

t 

DIAMOND 

o 

DIV 

-i- 

MP 


ODOT 

© 

OMINUS 

© 

OPLUS 

© 

OSLASH 

0 

OTIMES 

0 
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<MATH CHAR> 


Table 1-3 (Cont.) 

<MATH_CHAR> Keywords and Symbols 

Keyword 

Symbol 

Binary Operators 

PM 

± 

SETMINUS 

\ 

SQCAP 

n 

SQCUP 

u 

STAR 

* 

TIMES 

X 

TRIANGLELEFT 

< 

TRIANGLERIGHT 

> 

UPLUS 

i±i 

VEE 

V 

WEDGE 

A 

WR 

1 


Relational Operators 


APPROX 


ASYMP 

X 

BOWTIE 

tx 

CONG 


DASHV 

H 

DOTEQ 

= 

EQUIV 

= 

FROWN 


GEO 

> 

GG 

> 

IN 

e 

LL 

< 

LEO 

< 

MID 

1 

MODELS 


Nl 


NOT_APPROX 

§6 

NOT_ASYMP 


NOT_CONG 


NOT_EQUIV 


NOT_EQ 

7^ 

NOT_GEQ 

2 
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<MATH CHAR> 


Table 1-3 (Cent.) 

<MATH_CHAR> Keywords and Symbols 

Keyword 

Symbol 

Relational Operators 

NOT_GT 

A 

NOT_LEQ 


NOT_LT 

A 

NOT_PRECEQ 

2< 

NOT_PREC 

2< 

NOT_SIMEQ 


NOT_SIM 

/ 

NOT_SQSUBSETEQ 


NOT_SQSUPSETEQ 

2 

NOT_SUBSET 


NOTSUBSETEQ 


NOT_SUCCEQ 

't 

NOT_SUCC 

i- 

NOT_SUPSETEQ 

2 

NOT_SUPSET 

2 

PARALLEL 

II 

PERP 

± 

PRECEQ 

:< 

PREC 


PROPTO 

a 

SIMEQ 

r\j 

SIM 


SMILE 

Sw' 

SQSUBSETEQ 

c 

SQSUPSETEQ 

□ 

SUBSETEQ 

c 

SUBSET 

c 

SUCCEQ 


SUCC 


SUPSETEQ 

D 

SUBSET 

D 

VDASH 

h 
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<MATH CHAR> 


Table 1-3 (Cont.) <MATH_CHAR> Keywords and Symbols 


Keyword 

Symbol 

Arrows 

DOUBLE_DOWNARROW 


DOUBLE_LEFTARROW 


DOUBLE_LEFTRIGHTARROW 


DOUBLE_LONGLEFTARROW 


DOUBLE_LONGLEFTRIGHTARROW 


DOUBLE_LONGRlGHTARROW 


DOUBLE_RIGHTARROW 

=f> 

DOUBLE_UPARROW 

1V 

DOUBLE_UPDOWNARROW 


DOWNARROW 

i 

HOOKLEFTARROW 

<— > 

HOOKRIGHTARROW 


LEFTARROW 

<— 

LEFTHARPOONDOWN 

r- 

LEFTHARPOONUP 


LEFTRIGHTARROW 


LONGLEFTARROW 


LONGLEFTRIGHTARROW 


LONGMAPSTO 

1—. 

LONGRIGHTARROW 

— > 

MAPSTO 


NEARROW 

/ 

NWARROW 

\ 

RIGHTARROW 

-> 

RIGHTHARPOONDOWN 


RIGHTHARPOONUP 

-- 

RIGHTLEFTHARPOONS 


SEARROW 

\ 

SWARROW 

/ 


UPARROW t 

UPDOWNARROW | 
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<MATH CHAR> 


Table 1-3 (Cent.) <MATH_CHAR> Keywords and Symbols 


Keyword 

Symbol 

Delimiters 

LANGLE 

( 

BANGLE 

) 

LBRACE 

{ 

RBRACE 

} 

LBRACK 

[ 

RBRACK 

] 

LCEIL 

[ 

RCEIL 

1 

LFLOOR 

L 

RFLOOR 

J 


EXAMPLE 


The following example lists math expressions using the <MATH_CHAR> tag. 


<LIST>(SIMPLE) 

<le><MATH>(x=y>z) 

<le><MATH>(x:=y) 

<le><MATH>(x<math_char>(leq)y<math_char>(not_eq)z) 
<le><MATH>(x<math_char>(sim)y<math_char>(simeq)z) 
<le><MATH>(x<math_char>(equiv)y<math_char>(not_equiv)z) 
<le><MATH>(x<math_char>(subset)y<math_char>(subseteq)z) 
<ENDLIST> 


This example produces the following output: 

x = y > z 

x:= y 

x<y^z 

X'^yC:iZ 

x=y^z 

xCyCz 
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<MCS> 


<MCS> 


Labels a character in the Digital Multinational Character Set. 


FORMAT <fACS> (character) 


ARGUMENTS character 

Specifies the character you want. The character may be any one of the 
following: 


Argument Character 

spanish_invertecl_excIamation i 

cents 0 

british_pound £ 

japanese__yen ¥ 

section_sign § 

general_currency n 

copyright © 

feminine_orclinal ^ 

double_open_angle_brackets « 

degree ° 

plus_or_minus ± 

superscript 2 2 

superscripts 3 

micro p 

pilcrow H 


raised_period 
superscript! 
masculine ordinal 


double_close_angle_brackets » 

onejourth Va 

one_half Va 

spanishJnverted_question ^ 

cap_a_grave A 

cap_a_acute A 

cap_a_circumflex A 

cap_a_tilde A 

cap_a_umlaut A 

cap_a_ring A 






<MCS> 


Argument 


Character 


cap_ae 

cap_c_ceclilla 

cap_e_grave 

cap_e_acute 

cap_e_circumflex 

cap_e_umlaut 

cap_i_grave 

capj_acute 

capj_circumflex 

capj_umlaut 

cap_n_tilde 

cap_o_grave 

cap_o_acute 

cap_o_circumflex 

cap_o_tilde 

cap_o_umlaut 

cap_oe 

cap_o_slash 

cap_u_grave 

cap_u_acute 

cap_u_circumflex 

cap_u_unilaut 

cap_y_umlaut 

german_ss 

small_a_grave 

small_a_acute 

smalLa_ci rcumflex 

small_a_tilde 

smalLa_umlaut 

small_a_ring 

small_ae 

smalLc_cedilla 

small_e_grave 

small_e_acute 

small_e_circumflex 

small_e_umlaut 

smallj_grave 

smallj_acute 

small i circumflex 


fE 

Q 

fe 

E 

e 

E 

] 

\ 


N 

6 

6 

6 

0 

o 

CE 

0 

0 

u 

0 

0 

Y 

B 

k 

k 

a 

a 

a 

k 

ad 

5 

e 

e 

e 

e 

I 

i 

i 


1-187 





<MCS> 




Argument 

Character 


smallj_umlaut 

I 


small_n_tilde 

n 


small_o_grave 

6 


small_o_acute 

6 


smalLo_circumflex 

6 


small_o_tilde 

6 


small_o_umlaut 

0 


small_oe 

oe 


small_o_slash 

0 


small_u_grave 

u 


small_u_acute 

u 


small_u_circumflex 

u 


small_u_umlaut 

u 


smalLy_umlaut 

y 




related tags 

• <MATH_CHAR> 



• <SPECIAL_CHAR> 


restrictions 

Invalid in the context of a <MATH> tag. 



DESCRIPTION The <MCS> tag labels a character in the Digital Multinational Character 

Set. Use this tag when the terminal you are using does not accept or 
display these special characters. 


EXAMPLE The following example shows how to use the <MCS> tag. 

<P>The Digital Multinational Character Set includes the currency sign 
for the Japanese yen (<MCS>(japanese_yen)). 

This example produces the following output: 

The Digital Multinational Character Set includes the currency sign for the 
Japanese yen (¥). 
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ARGUMENTS None. 


related tags • <table> 

• ^TABLE_FILE> 

restrictions Valid only within a nested table. 

Invalid between paragraphs in a single table row. 

Breakpoints for long tables nested inside multipage tables have the 
following limitations: 

• The first level table must not use the KEEP argument in the <TABLE_ 
ATTRIBUTES> tag. 

• The first level table must only have two or three columns, which you 
set up using the <TABLE_SETUP> tag. 


DESCRIPTION The <NESTED_TABLE_BREAK> tag marks a place where a nested table may 

be broken across pages. A nested table is a table that is coded within 
another table. You create a nested table by placing the appropriate table 
tags within an argument to the <TABLE_ROW> tag of the outer table. Place 
the <nested_table_bREAK> tag between table rows of a nested table. This 
marks a place that the nested table may be broken across pages. This tag 
has no effect for Bookreader output. 

If you place a <NESTED_TABLE_BREAK> tag in a nested table that contains 
headings, the headings are not repeated on subsequent pages. Also, a rule 
may be output at the point that you include the <NESTED_TABLE_BREAK> 
tag, thereby appearing to end the nested table that continues on the next 
page. 


EXAMPLE The following example shows how to use the <NESTED_TABLE_BREAK> tag. 
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<NESTED_TABLE_BREAK> 


<TABLE>(Table Caption\tab_log_name) 

<TABLE_SETUP>(2\10) 

<TABLE_HEADS>(First Head\Second Head) 

<TABLE_ROW>(Item Here\Definition for Item here.) 

<TABLE_ROW>(Item Here\Definition that tells about nested table. 
<COMMENT>(*nested table begins*) 

<TABLE> 

<TABLE_SETUP>(2\15) 

<TABLE_ROW>(Item\Text of item description here) 
<TABLE_ROW>(Item\Text of item description here) 


<TABLE_ROW>(ItemNText 
<TABLE_ROW>(Item\Text 
<NESTED_TABLE_BREAK> 
<TABLE_ROW>(Item\Text 


of item description here) 
of item description here) 

of item description here) 


<TABLE_ROW>(Item\Text of item description here) 
<NESTED_TABLE_BREAK> 

<TABIjE_ROW> (Item\Text of item description here) 


<TABLE ROW>(Item\Text of item description here) 


<TABLE_ROW>(Item Here\Definition for Item here.) 
<TABLE_ROW>(Item Here\Definition for Item here.) 
<ENDTABLE> 

<COMMENT>(*nested table ends*) 

) 

<TABLE_ROW>(Item Here\Definition for Item here.) 
<TABLE_ROW>(Item Here\Definition for Item here.) 
<TABLE_ROW>(Item Here\Definition for Item here.) 
<ENDTABLE> 
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<NEWTERM> 


<NEWTERM> 

Labels a term introduced into the text for the first time. The term is italicized 
in output. 

FORMAT 

<NEWTERM>('fem7; 

ARGUMENTS 

term 

Specifies the new term you just introduced. 

related tags 

• <KEYWORD> 

• <VARIABLE> 

restrictions 

Invalid in the context of a <MATH> tag. 

DESCRIPTION 

The <NEWTERM> tag labels a term introduced into the text for the first 
time. The term is italicized in output. 

EXAMPLE 

The following example shows how to use the <NEWTERM> tag. 


<P>To begin a session at the terminal, you must first <NEWTERM>(log in). 
Logging in consists of identifying yourself as 
an authorized user. 


This example produces the following output: 

To begin a session at the terminal, you must first log in. Logging in 
consists of identifying yourself as an authorized user. 
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<NOTE> 


<NOTE> 

Labels a note, caution, warning, or some other portion of text that you want to 
draw attention to. 

FORMAT 

<HOTE>(note text) 

or 

<HOTE>[(heading text)] 

note text 

■ 

■ 


■ 

<ENDNOTE> 

ARGUMENTS 

heading text 

Specifies text for a heading other than the default heading “Note:”. 


note text 

Specifies the text of the note. A paragraph is implied here, so do not use a 
<P> tag. 

restrictions 

Do not use this tag immediately after a <SPAN> tag within a table. 

Invalid in the context of a <FOOTNOTE> tag. 

required 

terminator 

<ENDNOTE> — ^Required if you do not specify the note text argument to the 
<NOTE> tag. 

DESCRIPTION 

The <NOTE> tag labels a note, caution, warning, or some other portion of 
text that you want to draw attention to. A note is formatted differently 
depending on the doctype. 


EXAMPLE The following example shows how to use the <NOTE> tag. 


<NOTE>(Caution)You should abort the system generation command 
procedure only after Phase 1 has completed processing. 
<ENDNOTE> 


This example produces the following output: 

Caution: You should abort the system generation command procedure only 
after Phase 1 has completed processing. 
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<OPAREN> 


<OPAREN> 

Supplies an opening parenthesis anywhere in your file. You must use this tag, 
however, to specify an opening parenthesis within an argument to a tag, so 
that the opening parenthesis is not interpreted as the opening parenthesis of 
the tag’s argument. 

FORMAT 

<OPAREN> 

ARGUMENTS 

None. 

related tags 

• The following tags label other characters that you must tag when they 
occur in an argument to a tag: 

<AMPERSAND> 

<BACKSLASH> 

<CPAREN> —^required only if there is no opening parenthesis 
<VBAR> 

DESCRIPTION 

The <OPAREN> tag supplies an opening parenthesis an5rwhere in your file. 
You must use this tag, however, to specify a opening parenthesis within an 
argument to a tag, so that the opening parenthesis is not interpreted as 
the opening parenthesis of the tag’s argument. 

Using the tag, then, is only beneficial (in terms of keystrokes and control 
of the output) as an unmatched opening parenthesis in an argument to 
a tag. An unmatched parenthesis in an argument can cause errors when 
processed, because parentheses are used to determine the beginning and 
ending of an argument list. 

EXAMPLE 

The following example shows how to use the <OPAREN> tag. 


<SUBHEAD1>(Using an Opening Parenthesis <PARENDCHAR> 

(<OPAREN>) in an Argument to a Tag\oparen) 

This example produces the following output: 

Using an Opening Parenthesis (() in an Argument to a Tag 
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<ORDER NUMBER> 


<ORDER_NUMBER> 

Labels the order number or part number that appears on the title page of a 
book. 

FORMAT 

<ORDER_NUMBER>(ntym£»er; 

ARGUMENTS 

number 

Specifies the order number for the book. 

restrictions 

Valid only in the context of a <TITLE_PAGE> tag. 

DESCRIPTION 

The <ORDER_NUMBER> tag labels the order number or part number that 
appears on the title page of a book. This tag has no effect for Bookreader 
output. 

EXAMPLE 

See the example in the discussion of the <FRONT_MATTER> tag. 
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<p> 


<p> 

Marks the beginning of a new paragraph. 

FORMAT 

<P> 

ARGUMENTS 

None. 

related tags 

• <CENTER_LINE> 

• <CP> 

• <LINE> 

• <RIGHT_LINE> 

DESCRIPTION 

The <P> tag marks a new paragraph. An internal counter keeps track of 
the context in which the new paragraph begins. This allows you to freely 
use <P> tags inside lists and in other contexts where you want to start a 
new paragraph, while maintaining the same logical level of discussion. 

A <P> tag is expected after every heading. If you do not immediately start 
a new paragraph after a heading, you must label the beginning of another 
text element, such as a list. 

A <P> tag also specifies that the text that follows it is an online chunk. 

If you code an index entry within the paragraph, when you click on that 
entry in the Bookreader’s index, the paragraph in which you coded the 
entry appears. 

EXAMPLES 

The following example shows how to use the <P> tag. 


B <£■> 

Here is a sentence or two in a paragraph. The following paragraph 
will show the <TAG>(P) tag at work separating paragraphs. 

<P>Here is the second paragraph so that you can observe the relationship 
it has to the first. 

This example produces the following output: 

Here is a sentence or two in a paragraph. The following paragraph will 
show the <P> tag at work separating paragraphs. 

Here is the second paragraph so that you can observe the relationship it 
has to the first. 
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<p> 


The following example shows how to use a <P> tag within a list. 


§ <list>(unnumbered) 

<le>Oranges 

<le>Apples 

<p>Note that there are several types of apples<hellipsis> 

<le>Bananas 

<endlist> 


This example produces the following output: 

• Oranges 

• Apples 

Note that there are several types of apples . .. 

• Bananas 
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<PAGE> 


<PAGE> 

Breaks a page of text, forcing the text that follows the tag to begin on a new 
page. 

FORMAT 

<PAGE>/r{|^E«},; 

ARGUMENTS 

EVEN 

ODD 

These are optional keyword arguments. They specify that the next page 
of output, have an even or an odd page number. If you use EVEN, and 
depending on where you put the <PAGE>(EVEN) tag, you will have two 
consecutive pages of output numbered lO and 12, for example. If you use 
ODD, and depending on where you put the <page>(ODD) tag, you will have 
two consecutive pages of output numbered 13 and 15, for example. There 
is no blank page of output between the pages. 

related tags 

• <final_cleanup>(PAGE_BREAK) 

• <ONLINE_CHUNK> 

restrictions 

Invalid in the context of a <MATH> tag. 

The arguments EVEN and ODD are invalid in tables. 

If you use this tag in a table to force a page break, the table headings are 
not repeated on the page after the break. You must repeat the <TABLE_ 
HEADS> tag immediately after the <PAGE> tag to restore the default table 
headings. Headings are repeated on each page of a table only when 
DOCUMENT is allowed to break the table across pages. 

DESCRIPTION 

The <PAGE> tag breaks a page of text, forcing the text that follows the tag 
to begin on a new page. Using the <PAGE> tag has no effect for Bookreader 
output. 

Note: 

Use this tag only in special cases, where a page must be broken 
at that point. This tag is not for general use, such as for overall 
pagination; this can jeopardize the output format and device 
independence of your generically coded source file. 






<PAGE> 


EXAMPLE 


<HEAD1>(Survey Results) 


<PAGE> 

<HEAD2>(Brand X) 


<PAGE> 

<HEAD2>(Brand Z) 


The following example shows how to code a short document in which the 
information might be easier to locate when specific headings start on new 
pages. 




<PARENDCHAR> 


<PARENDCHAR> 


Supplies parentheses around a character you specify, resulting in better 
spacing of the character between the parentheses. 


FORMAT <PARENDCHAR>rc/7ar; 


ARGUMENTS char 

Specifies the character within parentheses. You specify only the character; 
the parentheses are added during processing. 


restrictions invalid in the context of a <MATH> tag. 


DESCRIPTION The <PARENDCHAR> tag supplies parentheses around a character you 

specify, resulting in better spacing of the character wdthin the parentheses. 
Frequently, writers use the name for a special character followed by that 
character in parentheses. For instance, in discussing wildcard characters, 
it is usual to say, “The percent sign (%) is the wildcard for a single 
character.” 

A problem in using proportionally spaced fonts is that single characters 
surrounded by parentheses can look crowded, like this: “The percent sign 
(%) is the wildcard for a single character.” Compare the percent sign in 
parentheses in this paragraph to the percent sign in parentheses in the 
previous paragraph; you can see the slight crowding of the percent sign in 
this paragraph. 

IVpographers put a small amount of space, called a “thin space,” between 
the parentheses and the single character to achieve a balance. When you 
use the <PAEENDCHAR> tag, that thin space is added for you. 

Use the <PARENDCHAR> tag to label characters that are small or that are 
more vertical than horizontal in shape. The parentheses are added during 
processing. 


EXAMPLE The following example shows how to use the <PAKENDCHAR> tag. 

<P>The tilde <PARENDCHAR>(~) is used to prevent the word 
following it from becoming a main entry in the index. 

This example produces the following output: 

The tilde (~) is used to prevent the word following it from becoming a 
main entry in the index. 

Without the <PARENDCHAR> tag, your output would look like this: 

The tilde (~) is used to prevent the word following it from becoming a main 
entry in the index. 
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<PART> 


<PART> 

Labels the start of a major division within a document and starts it on a new 
page. 

FORMAT 

<PART>[(part titlef 1 symbol name])] 

ARGUMENTS 

part title 

This is an optional argument for printed output when you process a 
single file, but required if you include the file in a bookbuild, including a 
Bookreader bookbuild. This argument specifies the title for this part of 
your document. 


symbol name 

This is an optional argument for printed output when you process a 
single file, but required if you include the file in a bookbuild, including a 
Bookreader bookbuild. This argument specifies the term that you assign 
to this part and then use to reference the part throughout your document. 


Symbol names must not exceed 31 characters and must only contain 
alphabetic letters, numbers, or underscores. Do not begin a s 3 nnbol name 
with an underscore. 

related tags 

• <PART_PAGE> 


DESCRIPTION The <PART> tag labels the start of a major division within a document and 

starts it on a new page. Parts may consist of the following: 


• A set of chapters or appendixes whose contents are logically related. 
The chapters or appendixes are numbered sequentially from the 
start of the document to the end, regardless of the parts; that is, the 
chapters or appendixes within each part do not begin at “1”. 

• A collection of units of logically related information, for example, 
reference items in the SOFTWARE doct 3 q)e. 

Like chapters, parts are automatically numbered. If you specify a symbol 
name argument, a symbol table entry is created for the part. The part title 
and symbol name arguments are required for Bookreader output. 

The <PART_PAGE> tag creates a divider page for a part. You can specify a 
title for the part that is printed on the part page, a running title for the 
part (same or different from the title) that is printed on each page of the 
part, and an abstract printed on the part page to describe the information 
in the part. 





<PART> 


By default, the part page is assigned the next odd page number in the 
current numbering sequence (except for Bookreader output, where there 
are no page numbers) in a document that does not have chapters. If you 
specify the RENUMBER argument to the <ENDPAET_PAGE> tag, the part 
page is assigned the number 1, and the next printed page of output is 
assigned the number 3. See the <ENDPART_PAGE> tag description for more 
information. 

Using the RENUMBER argument and the <RUNNING_TITLE> tag have no 
effect for Bookreader output. 

DOCUMENT considers each part to be an online topic. See VAX 
DOCUMENT Producing Online and Printed Documentation for more 
information about online topics. 


EXAMPLE 


The following example shows how to use the <PART> tag. 


<part>(Introduction to Global Tags\intro_part) 

<part_page> 

<title>(<reference>(intro_part)\<reference>(intro_part\text)) 
<abstract> 

This part contains introductory chapters. <reference>(ref_part) 
contains more detailed reference information. 

<endabstract> 

<running_title>(Introduction to Global Tags) 

<endpart_page>(RENUMBER) 


This example produces the following output on the part page if this is the 

first part specified in the document: 

• The <PART_PAGE> tag creates a new page of output. The page is 
assigned the next odd page number in the numbering sequence. 

• The title: “PART I Introduction to Global Tags” will be printed at the 
top of the part page. The first <REFERENCE> tag within the <TITLE> 
tag generates “PART I”; the second <REFERENCE> tag generates 
“Introduction to Global Tags”, as a result of using the text argument. 
You need to use the two <REFERENCE> tags to create both the part 
number and the part title. The use of uppercase Roman numerals to 
display the part number depends on the doctype you use. 

• The abstract text is printed. 

• The running title, “Introduction to Global Tags” is printed on each 
page of the part. 

• Using the RENUMBER argument to the <ENDPART_PAGE> tag assigns 
the part page to be number 1, and the next printed page is assigned 
to be page 3. If you do not use the RENUMBER argument, the part 
page is assigned the next odd page number in the current numbering 
sequence in a document that does not have chapters. 




<PART PAGE> 


<PART_PAGE> 

Inserts a divider page for a new part of a document. 

FORMAT 

<PART_PAGE> 

ARGUMENTS 

None. 

related tags 

• <ABSTRACT> 

• <PART> 

• <RUNNING_TITLE> 

• <TITLE> 

required 

terminator 

<ENDPART_PAGE> 

DESCRIPTION 

The <PART> tag inserts a divider page for a new part of a document. You 
can use the <TITLE>, <RIJNNING_TITLE>, and <ABSTRACT> tags to provide 
infomation on the part page and to specify a running title for that part of 
your document. 

The <RUNNING_TITLE> tag has no effect for Bookreader output. 

EXAMPLE 

See the example in the discussion of the <PART> tag. 
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<PREFACE> 


<PREFACE> 

Labels the beginning of a preface. 

FORMAT 

<PREFACE>/’(page number [\symbol name])} 

ARGUMENTS 

page number 

This is an optional argument. It specifies the page number on which you 
want the preface to begin. You must specify the number with an Arabic 
numeral (the number in the formatted result will be a lowercase Roman 
numeral). If you do not specify a number, the default page on which the 
preface begins is Roman numeral five (v). This argument has no effect for 
Bookreader output. 

symbol name 

This is an optional argument. It specifies the name of the symbol 
used in all references to this heading. Symbol names must not exceed 

31 characters and must only contain alphabetic letters, numbers, or 
underscores. Do not begin a s 5 mibol name with an underscore. 

related tags 

• <PREFACE_SECTION> 

restrictions 

Valid only in the context of a <FRONT_MATTER> tag. 

required 

terminator 

<ENDPREFACE> 


DESCRIPTION The <PREFACE> tag labels the beginning of a preface. If you want the 

preface of your document placed after the table of contents, which usually 
begins on page (Roman numeral) iii, you must specify the starting page 
number for the preface for printed output; the page number argument has 
no effect for Bookreader output. You cannot know what this number will 
be until the document is nearly completed and you know what the page 
count is for the table of contents. 

The preface always begins on a right-hand page following the table of 
contents; thus, it always begins with an odd page number, by default 
the Roman numeral five (v). You must adjust the page numbering of the 
preface, however, if the table of contents is longer than you expected (that 
is, longer than three pages). 

If the table of contents ends on an even page (therefore, a left-hand page), 
you add one to the preface’s page number, which starts the preface on the 
right-hand page. For example, if the table of contents ends on page 8, you 
would use the following tag to specify that the preface begin on page 9: 


<PREFACE>(9) 






<PREFACE> 


If the table of contents ends on an odd page (therefore, a right-hand page), 
you add two to that page number, which starts the preface on the right- 
hand page (and in this case, leaving a blank left-hand page). For example, 
if the table of contents ends on page 9, you would use the following tag to 
specify that the preface begin on page 11: 

<PREFACE>(11) 

You cannot reference any headings from the preface; sections you code 
within the preface with <HEADn> tags are unnumbered and do not produce 
table of contents entries. 

If your preface includes a section that you want to appear in the table of 
contents, you must code it as follows: 

<PREFACE_SECTION>(New Section) 

DOCUMENT considers the preface to be an online topic. See VAX 
DOCUMENT Producing Online and Printed Documentation for more 
information about online topics. 

EXAMPLE See the example in the discussion of the <FRONT_MATTER> tag. 
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<PREFACE_SECTION> 


<PREFACE_ 

SECTION> 

Creates a major section in the preface of a book to provide information, such 
as a summary of changes to the book. 

FORMAT 

<PREFACE_SECTION>('f/f/e /■! symbol name]) 

ARGUMENTS 

title 

Specifies the title you give to the preface section. 

symbol name 

This is an optional argument. It specifies the name of the symbol 
used in all references to this heading. Symbol names must not exceed 

31 characters and must only contain alphabetic letters, numbers, or 
underscores. Do not begin a symbol name with an underscore. 

related tags 

• <PREFACE> 

restrictions 

Valid only in the context of a <FRONT_MATTER> tag. 

DESCRIPTION 

The <PREFACE_SECTlON> tag creates a major section in the preface of a 
book to provide information, such as a summary of changes to the book. 

Note that because <HEADn> tags in a preface do not produce table of 
contents entries, you must code sections of your preface that you want to 
appear in the table of contents as follows: 

<PREFACE_SECTION>(New Section) 

EXAMPLE 

See the example in the discussion of the <FRONT_MATTER> tag. 







<PRINT DATE> 


<PRINT_DATE> 

Inserts a print date line on the copyright page. 

FORMAT 

<PRINT_DATE>ftfafe; 

ARGUMENTS 

date 

Specifies official printing date information for the book. 

restrictions 

Valid only in the context of a <C0PYRIGHT_PAGE> tag in the front matter of 
a document. 

DESCRIPTION 

The <PRINT_DATE> tag inserts a print date line on the copyright page. 

EXAMPLE 

See the example in the discussion of the <FRONT_MATTER> tag. 
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<PROFILE> 


<PROFILE> 

Indicates that the source file is a profile that generates a bookbuild. 

FORMAT 

<PROFILE> 

ARGUMENTS 

None. 

related tags 

• <ELEMENT> 

• <INCLUDES_FILE> 

required 

terminator 

<ENDPROFILE> 


DESCRIPTION The <PR0FILE> tag indicates that the source file is a profile that generates 

a bookbuild. A profile of a book is required in order to build (process) a 
book. Between the <PR0FILE> and <ENDPR0FILE> tags, you introduce each 
element of the book with an <ELEMENT> tag. 

Only those files listed with <ELEMENT> tags are included in the book 
during the bookbuild. List them in the profile in the order in which they 
appear in the book. 

Within a profile file, never include a tag that produces text. Also, do not 
place an <INCLUDE> tag in a profile. 

There are several optional tags that you can include between the 
<PR0FILE> and <ENDPR0FILE> tags, other than <ELEMENT> tags. These 
include the following: 

• <COMMENT> and <ENDCOMMENT> 

• <CONDITION> and <ENDCONDITION> 

• <CONTENTS_FILE> 

• <INCLUDES_FILE> 

• <INDEX_FILE> 

• <REVISION> 

• <SET_CONDITION> 

• <SET_ONLINE_TOPIC> 

See VAX DOCUMENT Producing Online and Printed Documentation for 
more information on bookbuilding. 
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<PROFILE> 


EXAMPLE The following example shows the profile of a hook that contains a table of 

contents, four chapters, an appendix, and an index. The profile shown in 
this example must be in a file by itself. You should call the file by a name 
that indicates it is a profile, such as “COMPUTER_PROFILE.SDML.” 

Each of the files named in the <ELEMENT> tags should begin with one of 
the book element tags, such as <CHAPTER>(Introduction\introduction_ 
chap). 

<PROFILE> <COMMENT>(***Profile for How to Use a Computer***) 

<CONTENTS_FILE> <COMMENT>(***insert table of contents here***) 

<ELEMENT>(Mydisk:[Mydirectory]front_matter.sdml) 

<ELEMENT>(Mydisk:[Mydirectory]intro_chap.sdml) 

<ELEMENT>(Mydisk:[Mydirectory]applications_chap.sdml) 

<ELEMENT>(Mydisk:[Mydirectory]tools_chap.sdml) 

<ELEMENT>(Mydisk:[Mydirectory]conclusion_chap.sdml) 

<ELEMENT>(Mydisk:[Mydirectory]questions_app.sdml) 

<INDEX_FILE> <COMMENT>(***insert index here***) 

<ENDPROFILE> 
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<QUOTE> 


<QUOTE> 

Encloses text in quotation marks. The quotation marks appear as if they are 
typeset. 

FORMAT 

<QUGTE> (quoted text) 

or 

<QUOTE> 
quoted text 

■ 


■ 

<ENDQUOTE> 

ARGUMENTS 

quoted text 

Specifies the quoted text. 

related tags 

• <DOUBLE_QUOTE> 


• <SINGLE_QUOTE> 

required 

terminator 

<ENDQUOTE> — ^Required if you do not specify the quoted text argument to 
the <QUOTE> tag. 


DESCRIPTION The <QUOTE> tag encloses text in quotation marks. The quotation marks 

appear as if they are typeset. 


Your terminal keyboard has two possible characters you can use for 
quotation marks: the double quote ( " ) (ASCII 34) and the single quote 
(' ) (ASCII 39). Neither distinguishes between opening quotation marks 
and closing quotation marks. You use the same character twice to enclose 
a word in quotation marks. 

Documents that are typeset, however, use distinct opening quotation 
marks and closing quotation marks. To obtain these distinct quotation 
marks in your output, label the text you want inside the quotation marks 
with the <QUOTE> tag. If you use the keyboard quote character instead of 
the <QUOTE> tag, the opening and closing quotation marks in your output 
will not be different from each other. 
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<QUOTE> 


EXAMPLES The following example shows how to use the <QUOTE> tag to obtain distinct 

opening and closing quotation marks in your output. 

Q <P>The symbol B will be defined to be the string <QUOTE>(April 
showers.) 

This example produces the following output: 

The symbol B will be defined to be the string “April showers.” 

The following example shows the same output as the first example using 
the keyboard quotation marks instead of using the <QUOTE> tag. 

§ <P>The symbol B will be defined to be the string "April 
showers." 

This example produces the following output: 

The symbol B will be defined to be the string "April showers." 

The following example shows how to code some text if you want a 
punctuation mark outside the quotation marks. Put the punctuation 
mark outside of the closing parenthesis of the argument to the <QUOTE> 
tag or after the <endquote> tag. 

§ <P>Did Abraham Lincoln write, <QUOTE> I claim not to have controlled 

events, but confess plainly that events have controlled me <ENDQUOTE>? 

This example produces the following output: 

Did Abraham Lincoln write, “ I claim not to have controlled events, but 
confess plainly that events have controlled me ”? 
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DESCRIPTION The <REFERENCE> tag makes a reference to a symbol name in a book 

element or text element. When processed, the <REFERENCE> tag is 
replaced with the current value of the symbol name that is stored in 
the cross-reference file. 

A second argument to the tag controls the exact output of the reference. 
When you do not specify a second argument, the output defaults according 
to whether the S 5 rmbol refers to a heading, a figure, a table, a chapter, and 
so on. Table 1-4 summarizes the default output for each type of text or 
book element. 
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<REFERENCE> 


Table 1-4 Element Types and Default Output of Symbol Names 




Second Argument to <REFERENCE> 

Text Element 

(default) 

VALUE 

TEXT 

FULL 

BOOK TITLE 

The title argument specified in 

<DEFINE_BOOK 

_NAME>. 

EXAMPLE 

“Example” number 

number 

caption 

“Example” number, caption 

FIGURE 

“Figure” number 

number 

caption 

“Figure” number, caption 

HEADn 

“Section” number 

number 

caption 

“Section” number, caption 

TABLE 

“Table” number 

number 

caption 

“Table” number, caption 

TEXT STRING 

The text string argument specified in <DEFINE_SYMBOL>. 

Book Elements 

(default) 

VALUE 

TEXT 

FULL 


APPENDIX 

“Appendix” letter 

letter 

title 

“Appendix” letter, title 

CHAPTER 

“Chapter” number 

number 

title 

“Chapter” number, title 

PART 

“Part” number 

number 

title 

“Part” number, title 

SECTION 

“Section” number 

number 

title 

“Section” number, title 


See VAX DOCUMENT Producing Online and Printed Documentation for 
more information on symbol names and cross-referencing. 

For a book you create for Bookreader, you must use the <REFERENCE> tag 
to allow DOCUMENT to automatically cross-reference the S 5 anbol names 
you assign to the tag. 

The following tags require a symbol name for a book you create for 
Bookreader: 

• <APPENDIX> 

• <CHAPTER> 

• <CHEAD> 

• <EXAMPLE> 

• <FIGURE> 

• <HEAD> 

• <HEADn> 

• <PREFACE> 

• <PREFACE_SECTION> 

• <SUBHEADn> 

• <TABLE> 


<COMMAND> 








<REFERENCE> 


• <KOUTINE> 

• <SDML_TAG> 

• <STATEMENT> 

• <SUBCOMMAND> 

The last five tags are listed in VAX DOCUMENT Using Doctypes and 
Related Tags. 

The following tags accept a symbol name, but do not require one, for both 
printed books and books you create for Bookreader: 

• <FRONT_MATTER> 

• <GLOSSARY> 

• <PART> 

• <MATH> 

The following tags, listed in VAX DOCUMENT Using Doctypes and Related 
Tags, accept a S 5 mibol name for a printed book; the tags are ignored for 
books you create for Bookreader: 

• <REF_NOTE> 

• <SECTION> 

When you use the <REFERENCE> tag to refer to a formal example, figure, 
or table, the words that appear in the hotspot are directly related to 
the way you code the <REFERENCE> tag. For example, suppose you enter 
a <REFERENCE>(syinbol name\VALUE) tag when referring to a hotspot, but 
you physically type in an identif 5 dng reference before the tag, like “See 
Figure <REFERENCE>(symbol name\ VALUE)”. The word that you used as the 
identifying reference will appear ouside of the hotspot; for example, “1-1” 
would appear in the hotspot, but “Figure” would not. 


EXAMPLES The following example shows how to use the <REFERENCE> and <TABLE> 

tags to make a default reference to the symbol name of a table. The 
symbol name ‘lognames_tab” is defined in the <TABLE> tag and then 
referred to with the <reference> tag. 

Q <REFERENCE>(lognames_tab) shows ten default system logical names. 

<TABLE>(System Logical Names\lognames_tab) 


This example produces the following output: 

Table 1-4 shows ten default system logical names. 

For Bookreader output, “Table 1-4” is a hotspot: | Table 1 -41 . 
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<REFERENCE> 


The following example shows how to use the <REFERENCE> and <TABLE> 
tags to refer to the table in full, that is, to refer to the number and name 
of the table. The sjnnbol name “lognames_tab” is defined in the <TABLE> 
tag and then referred to with the <REFERENCE> tag. 

<REFERENCE>(lognames_tab\full) shows ten default system logical names. 

<TABLE>(System Logical Names\lognames_tab) 


This example produces the following output: 

Table 1-4, System Logical Names, shows ten default system logical names. 

For Bookreader output, “Table 1-4, System Logical Names” is a hotspot: 

I Table 1-4, System Logical Names | . 

The following example shows how to use the <REFERENCE> and <HEAD1> 
tags to refer to the text of the heading. The symbol name “assigning_ 
attributes” is defined in the <HEADl> tag and then \ referred to with the 
<REFERENCE> tag. 

§ The <REFERENCE>(assigning_attributes\text) section describes the 
method to assign color to the objects on your screen. 

<HEAD1>(Assigning Color Attributes\assigning_attributes) 

This example produces the following output: 

The Assigning Color Attributes section describes the method to assign 
color to the objects on your screen. 

For Bookreader output, “Assigning Color Attributes” is a hotspot: 

I Assigning Color Attributes | . 

The following example shows how to use the <REFERENCE> tag to refer to 
a chapter number without outputting any related information, such as the 
chapter title. 

Q <P>See Chapters <REFERENCE>(lognames_chap\value) and 
<REFERENCE>(filespec_chap\value) to see . . . 

This example produces the following output: 

See Chapters 3 and 4 to see . . . 

For Bookreader output, “3” and “4” are hotspots: and fT] . 
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<REVISION> 


<REVISION> 

Indicates that the document contains either new or modified information. 

FORMAT 

<REVISION>/(UPDA7£/'l update info])] 

ARGUMENTS 

UPDATE 

This is an optional keyword argument, but you must specify it if you 
are producing the document for an update. If you specify UPDATE, the 
file must contain the <UPDATE_RANGE> and <ENDUPDATE_RANGE> tags 
to indicate the pages to be processed. If no <UPDATE_RANGE> tags are 
present, no output is produced. The UPDATE argument has no effect for 
Bookreader output. 


update info 

This is an optional argument. It specifies information that is related to 
the system version and the date of the update. The text appears on the 
bottom of each page of output in the update. The update info argument 
has no effect for Bookreader output. 

related tags 

• <MARK> 


• <UPDATE_RANGE> 

restrictions 

Invalid in the two multicolumn doctypes, ARTICLE and 
REPORT.TWOCOL. 


DESCRIPTION The <REVISION> tag indicates that the document contains either new 

or modified information. It enables the <MARK>, <ENDMAKK>, <UPDATE_ 
RANGE>, and <ENDUPDATE_RANGE> tags. By default, these tags are defined 
for all doctypes to be non-operational; that is, if a file is processed without 
the <REVTSI0N> tag, the related tags produce no output. 

You can produce update pages only for a printed document; you cannot 
produce them for Bookreader. 

When a file that contains the <REVISION>(UPDATE) tag is processed, the 
table of contents and index are handled as follows: if you specify 
/CONTENTS and /INDEX on the command line, you receive a table of 
contents and an index even if you do not specify the <C0NTENTS_FILE> and 
<INDEX_FILE> tags within the <UPDATE_RANGE> and <ENDUPDATE_RANGE> 
tags. 

Note: If the device converter encounters errors on point pages created 
using the <REVlSlON>(update) tag, it signals them as occurring on the 
original page, not the point page. For example, an error on point 
page 11-2.1 is signalled as occurring on page 11-2. 
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<REVISION> 


EXAMPLES 

Q <REVISION> 


The following example shows how to use the <REVISION> tag in a document 
that is extensively revised. 


<p> 

The following characters are legal in MACRO-11 source programs; 

<LIST>(UNNUMBERED) 

<LE>The letters A through Z. Both upper- and lowercase letters are 
acceptable, although, upon input, lowercase letters are converted to 
uppercase. 

<MARK> 

<LE>Characters in the Digital Multinational Character Set (MCS). A chart 
showing the MCS is located in <REFERENCE>(mcs_app), 
with a list of directives that support the MCS. 

<LE>The digits 0 through 9. 

<ENDMARK> 

<LE>The characters period <PARENDCHAR>(.) and dollar sign 
<PARENDCHAR>($). These characters are reserved for use as Digital 
Equipment Corporation system program symbols. 

<ENDLIST> 


This example produces the following output: 

The following characters are legal in MACRO-11 source programs: 

• The letters A through Z. Both upper- and lowercase letters are 
acceptable, although, upon input, lowercase letters are converted 
to uppercase. 

• Characters in the Digital Multinational Character Set (MCS). A chart 
showing the MCS is located in Appendix A, with a list of directives 
that support the MCS. 

• The digits 0 through 9. 

• The characters period (.) and dollar sign ($). These characters are 
reserved for use as Digital Equipment Corporation system program 
symbols. 

The following example shows how to use the <REVISI0N> tag to update a 

manual. See the <UPDATE_RANGE> tag description for more information on 

identifying a section of updated material. 

g <REVISION>(UPDATE\November 1990) 


<UPDATE_RANGE>(3\10) 
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<REVISION INFO> 


1 

z 

o 

cn 

> 

UJ 

DC 

V 

_INFO> 

Labels a section on a title page that provides information on what previous 
books have been superseded by the current one. 

FORMAT 

<REVISION_INFO>(ff/Y/e text] 1 info) 

ARGUMENTS 

title text 

This is an optional argument. It specifies heading information. If you do 
not specify this argument, the default text “Revision/Update Information;” 
is supplied. 

info 

Specifies revision and update information. 

related tags 

• <FRONT_MATTER> 

restrictions 

Valid only in the context of a <TITLE_PAGE> tag. 

DESCRIPTION 

The <REVISI0N_INF0> tag labels a section on a title page that provides 
information on what previous books have been superseded by the current 
one. 

EXAMPLE 

See the example in the discussion of the <FRONT_MATTER> tag. 


1-217 







<RIGHT LINE> 


<RIGHT_LINE> 

Specifies a line of text that is to be alignecj against the right-hand margin of 
the page. 

FORMAT 

<RlGHT.LlNE>(tex,/{ 

ARGUMENTS 

text 

Specifies the line of text to be aligned against in the right-hand margin of 
the page. 

BIGSKIP 

SMALLSKIP 

These are optional keyword arguments. They specify that a set amount of 
vertical space precede the element identified as a line or block of text. The 
actual amount of space inserted is determined by the doctype. 

related tags 

• <CENTER_LINE> 

• <LINE> 

restrictions 

Invalid in the context of an <EXAMPLE> and a <MATH> tag. 

The aligned text must fit within the right-hand margin. If you specify text 
that is too wide, the text formatter issues a warning message, and you 
should examine your output. 

DESCRIPTION 

The <RIGHT_LINE> tag specifies a line of text that is to be aligned against 
the right-hand margin of the page. This text is said to be right-justified. 

Note: 

When you use the <RIGHT_LINE> tag as the first tag in a table column, 
it leaves extra space in that column. 

EXAMPLES 

The following example shows how to use the <RIGHT_LINE>(SMALLSKIP) tag. 


Q <P>Please include the following information: 

<RIGHT_LINE>(Name) 

<RIGHT_LINE>(Address\smallskip) 

<RIGHT_LINE>(Phone Number) 

This example produces the following output: 
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<RIGHT_LINE> 


Please include the following information: 

Name 

Address 
Phone Number 

The following example shows how to use the <RIGHT_LINE>(BIGSKIP) tag. 

<P>Please include the following information: 

<RIGHT_LINE>(Name) 

<RIGHT_LINE>(AddressXbigskip) 

<RIGHT_LINE>(Phone Number) 

This example produces the following output: 

Please include the following information: 

Name 


Address 
Phone Number 
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<RULE> 


<RULE> 

Outputs a horizontal rule in a table. 

FORMAT 

<RULE> 

ARGUMENTS 

None. 

related tags 

• <SPAN> 

• <TABLE_HEADS> 

• <TABLE_ROW> 

• <TABLE_UNIT_HEADS> 

restrictions 

Valid only in an argument to a <TABLE_ROW>, <TABLE_HEADS>, or <TABLE_ 
UNIT_HEADS> tag; it must immediately follow the argument text under 
which the rule is to be placed. 

DESCRIPTION 

The <RULE> tag outputs a horizontal rule in a table. You place a <RULE> 
tag inside an argument to a <TABLE_HEADS>, <TABLE_ROW>, or <TABLE_ 
UNIT_HEADS> tag. 

The horizontal length of the rule does not correspond to the dimensions of 
the table. It equals the width of the table column or the spanned columns, 
if the argument also is preceded by a <SPAN> tag. See the <SPAN> tag 
description for more information. 

EXAMPLE 

See the example in the discussion of the <TABLE_UNIT> tag. 






<s> 


<s> 

Labels the system portion of a dialog between user and system in an 
interactive example. 

FORMAT 

<S>(text) 

ARGUMENTS 

text 

Specifies the text of the system message. 

related tags 

• <INTERACTIVE> 

• <U> 

restrictions 

Invalid in the context of a <MATH> tag. 

DESCRIPTION 

The <S> tag labels the system portion of a dialog between user arid system 
in an interactive example. An example containing this type of dialog must 
have both parts identified in order to differentiate the two types of text in 
the source code, the output, or both. 

In the Software doctype, you can also use the <S> and <U> tags to 
differentiate the system and user text inside of examples created with 
the <EXAMPLE_SEQUENCE> and <EXI> tags. For more information on this 
doctype, refer to VAX DOCUMENT Using Doctypes and Related Tags. 

EXAMPLES 

The following example shows how to use the <S> tag. 


Q <P>The system prompt <S>($) indicates you can enter a command. 

This example produces the following output: 

The system prompt $ indicates you can enter a command. 

The following exaiiiple shows how to code dialog between both the system 
and the user. In a dialog, the <S> and <U> tags must be used between 
<INTERACTIVE> and <ENDlNTERACTrVE> tags. Note that you should specify, 
within the argument to the <S> tag, whatever space follows the system 
prompt. 
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<s> 


<P>The following example of VAXMAIL contains messages from both 
the system and a user of the system: 

<INTERACTIVE> 

<U>(mail) 

<S>(MAIL> )<U>(send) 

<S>(To: )<U>(nodename::Courtney) 

<S>(%MAIL-E-NOSUCHUSR, no such user COURTNEY at node NODENAME) 

<ENDINTERACTIVE> 

This example produces the following output: 

The following example of VAXMAIL contains messages from both the 
system and a user of the system: 

mail 

MAIL> send 

To: nodename::Courtney 

%MAIL-E-NOSUCHUSR, no such user COURTNEY at node NODENAME 
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<SAMPLE TEXT> 


<SAMPLE_ 

TEXT> 

Typographically distinguishes an extract of text. 

FORMAT 

<SAMPLE_TEXT> 

ARGUMENTS 

None. 

related tags 

• <CENTER_LINE> 

• <P> 

restrictions 

The <SAMPLE_TEXT> tag does not provide paragraph formatting. If you 
want to show a paragraph within the sample text, you must label it with a 
<P> tag. 

required 

terminator 

<ENDSAMPLE_TEXT> 

DESCRIPTION 

The <SAMPLE_TEXT> tag typographically distinguishes an extract of text. 
The sample text is indented from the normal text margins. 

EXAMPLE 

The following example shows how to use the <SAMPLE_TEXT> tag. 


<P>The language is perpetually in flux: it is a living stream, 

shifting, changing, receiving new strength from a thousand tributaries. . . 

<SAMPLE_TEXT> 

<P>Taken from Strunk, William Jr. and White, E.B.: The Elements of Style. 

Macmillan Publishing Co., Inc., 1979. 

<ENDSAMPLE_TEXT> 

This example produces the following output: 

The language is perpetually in flux: it is a living stream, shifting, 
changing, receiving new strength from a thousand tributaries. . . 

Taken from Strunk, William Jr. and White, E.B.: The 
Elements of Style. Macmillan Publishing Co., Inc., 1979. 







<SET APPENDIX LETTER> 


<SET APPENDIX LETTER> 


Overrides the default appendix letter assigned to an appendix by VAX 
DOCUMENT. 


FORMAT <SET_APPENDIX_LETTER> (appendix letter) 


ARGUMENTS appendix letter 

Specifies the letter of the appendix. This argument must be a letter from 
A to Z. 


related tags 


• <APPENDIX> 

• <SET_CHAPTER_NUMBER> 

• The MILSPEC doctype <SET_APPENDIX_NUMBER> tag 


DESCRIPTION The <SET_APPENDIX_LETTER> tag overrides the default appendix letter 

assigned to an appendix by VAX DOCUMENT. The tag is useful only in 
an element build to override the default appendix letter created by VAX 
DOCUMENT; it is ignored in a bookbuild. The <SET_APPENDIX_LETTER> 
tag resets the current appendix letter and resets the lettering for all 
following appendixes. For example, if you specified C as the argument, the 
<APPENDIX> tag generates Appendix C. The next <APPENDIX> tag generates 
Appendix D, and so on. 

Place the <SET_APPENDIX_LETTER> tag in your SDML file before the 
<APPENDIX> tags you want it to affect, because the <SET_APPENDIX_LETTER> 
tag affects only the <APPENDIX> tags that follow it. 

You can use the <SET_APPENDIX_LETTER> tag multiple times in an SDML 
file. 


EXAMPLE The following example shows how to use the <SET_APPENDIX_LETTER> 

tag. The appendix “Error Messages” is explicitly set to C using the 
<SET_APPENDIX_LETTER> tag. This causes any subsequent appendixes 
to be numbered beginning with the letter D, unless you use another 
<SET_APPENDIX_LETTER> tag to reset the current appendix letter. 


<SET_APPENDIX_LETTER>(C) 

<APPENDIX>(Error Messages\error_msg_app) 
<P> 

The following error messages... 







<SET CHAPTER NUI\/IBER> 


<SET CHAPTER NUMBER> 


Overrides the default chapter number assigned to a chapter by VAX 
DOCUMENT. 


FORMAT <SET_CHAPTER_mMBER>(chapternumber) 


ARGUMENTS chapter number 

Specifies the number of the chapter. This argument must be a positive 
integer. 


related tags • <chapter> 

• <SET_APPENDIX_LETTER> 


DESCRIPTION The <SET_CHAPTER_NUMBER> tag Overrides the default chapter number 

assigned to a chapter by VAX DOCUMENT. The tag is useful only in an 
element build to override the default chapter number created by VAX 
DOCUMENT; it is ignored in a bookbuild. The <SET_CHAPTER_NUMBER> 
tag resets the current chapter number and the numbering for all following 
chapters. For example, if you specify 13 as the chapter number, the 
next <CHAPTER> tag generates Chapter 13. The following <CHAPTER> tag 
generates Chapter 14, and so on. 

Place the <SET_CHAPTER_NUMBER> tag in your SDML file before the 
<CHAPTER> tags you want it to affect, because the <SET_CHAPTER_NUMBER> 
tag affects only the <CHAPTER> tags that follow it. 

You can use the <SET_CHAPTER_NUMBER> tag multiple times in an SDML 
file. 


EXAMPLE The following example shows how to use the <SET_CHAPTER_NUMBER> 

tag. The chapter is set to 13 using the <SET_CHAPTER_NUMBER> tag. This 
causes any subsequent chapters to be numbered beginning with number 
14, unless you use another <SET_CHAPTER_NUMBER> tag to reset the current 
chapter number. 


<SET_CHAPTER_NUMBER>(13) 

<CHAPTER>(Supported Devices\sup_dev_chap) 

<p> 

The primary supported devices... 
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<SET CONDITION> 


<SET CONDITION> 


Creates or removes a condition in your SDML file. 


FORMAT <SET_COUD\J\OH>(condition name[\ REMOVE]) 


ARGUMENTS condition name 

Specifies a name you use to conditionalize a portion of your SDML file. 
This name is limited to 28 characters. 

REMOVE 

This is an optional keyword argument. It removes the condition name. 


related tags • <condition> 


DESCRIPTION The <SET_C0NDITI0N> tag creates or removes a condition in your SDML 

file. You specify conditions with the <CONDITlON> tag. 

For a complete explanation of creating conditional text, refer to VAX 
DOCUMENT Producing Online and Printed Documentation. 

Normally, you create a condition at the front of your input file and it 
remains in effect for the rest of the file. If you want to process a portion 
of the input file without the condition, you can remove it by repeating the 
<SET_CONDITION> tag with the REMOVE argument. 

You can use the /CONDITION qualifier on the DOCUMENT command line 
instead of placing the <SET_CONDlTlON> tag into your file. For example, 
you might use the command hne qualifier /CONDITION=local instead of 
putting the <SET_CONDlTION>(local) tag in your input file. 


EXAMPLE The following example shows how to use the <SET_CONDITION> tag at the 

beginning of your file in order to establish the condition. In this case, 
the condition, set by the <SET_CONDlTION>(Christmas) tag, is “Christmas”. 
This means that only the information on Christmas, designated with the 
<CONDITION> tag, is processed. 

This example also shows how to use the <SET_CONDITION> tag with the 
REMOVE argument in order to remove the condition you set with the 
<SET_CONDlTION> tag. Removing the condition applies for the rest of your 
file. In this case, the first instance of Christmas information is processed, 
but all instances of Christmas information after the 
<SET_CONDlTlON>(Christmas\ REMOVE) tag are not processed. 
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<SET CONDITION> 


<SET_CONDITION>(Christmas) 

<C0ND1TI0N>(Christmas) 

<P>Christmas, by convention, is celebrated on December 25th . . . 
<ENDCONDITION> 

<CONDITION>(Chanukah) 

<P>Chanukah is called the Festival of Lights . . . 

<ENDCONDITION> 

<CONDITION>(Passover) 

<P>Passover is usually celebrated . . . 

<ENDCONDITION> 

<SET_CONDITION>(Christmas\REMOVE) 

<CONDITION>(Christmas\Chanukah) 

<HEAD1>(Religious Holidays) 

<P>This paragragh contains general information about several religious 
holidays . . . 

<ENDCONDITION> 
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<SET_FIGURE_ 

FILE_SPACING_DEFAULT> 

<SET_FIGURE_FILE_SPACINQ_DEFAULT> 

Override^ the default for vertical blank space that appears before and after an 
included graphics file. 

FORMAT 

<SET_FIGURE_FILE_SPACING_DEFAULT>f/spacebefore7 

1 [space after}) 

ARGUMENTS 

space before 

This is an optional argument. It specifies the amount of vertical space in 
picas that is to be output before the graphics file (there are 6 picas to an 
inch). This argument may be a nonnegative integer or decimal number, 
including zero. 

spaceafter 

This is an optional argument. It specifies the amount of vertical space in 
picas that is to be output following the graphics file (there are 6 picas to 
an inch). This argument may be a nonnegative integer or decimal number, 
including zero. 

related tags 

• <FIGURE> 

• <FIGURE_FILE> 

DESCRIPTION 

The <SET_FIGURE_FILE_SPACING_DEFAULT> tag overrides the default for 
vertical blank space that appears before and after an included graphics 
file. Each doctype specifies default values for spacing that is inserted 
before and after a graphics file included using the <FIGURE_FILE> tag. 
These defaults assume that the file does not have any built-in white space. 

In some instances, graphics files may have included white space, and 
you may not be able to remove it from the graphics file itself. In these 
instances, you can use the <SET_FIGURE_FILE_SPACING_DEFAULT> tag to 
modify the amount of white space that VAX DOCUMENT places before 
and after the graphics file. 

The values specified by the <SET_FIGURE_FILE_SPACING_DEFAULT> tag 
remain in effect for all subsequent figures, or until you use the 
<SET_FIGURE_FILE_SPACING_DEFAULT> tag again. 

If you do not specify one of the arguments to the <SET_FIGURE_FILE_ 
SPACING_DEFAULT> tag, the spacing remains as though you had not used 
the tag. 
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<SET FIGURE FILE SPACING DEFAULT> 


EXAMPLES The following example shows how to set the figure file spacing default to 0 

picas before a figure and 1,24 picas after a figure. All subsequent graphics 
files included using the <FIGURE_FILE> tag will also have this amount of 
white space around the figure. 

Q <SET_FIGURE_FILE_SPACING_DEFAULT>(0\1.24) 

<FIGURE>(Graphic File Inclusion) 

<FIGURE_FILE>(LN03\MY_FILES:HOUSE.SIX\13.76) 

<ENDFIGURE> 

In the following example, the figure file spacing is set to 10 picas before the 
figure and 0 picas after it. Using the second <SET_FIGURE_FILE_SPACING_ 
DEFAULT> tag resets the amount of spacing for any subsequent figures to 2 
picas before the figure and 2 picas after the figure. 

g <SET_FIGURE_FILE_SPACING_DEFAULT>(10\0) 

<FIGURE>(Graphic File Inclusion) 

<FIGURE_FILE>(LN03\MY_FILES:HOUSE.SIX\13.76) 

<ENDFIGURE> 

<SET_FIGURE_FILE_SPACING_DEFAULT>(2\2) 
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<SET_TABLE_ 

ROW_BREAK_DEFAULT> 

<SET_TAB LE_ROW_B R E AK_DEFAU LT> 

Overrides the default value for a multipage table’s first valid break. 

FORMAT 

<SET_TABLE_ROW_BREAK_DEFAULT>(>7t/m6e/- 0 ^ rows; 

ARGUMENTS 

number of rows 

Specifies the number of default table rows that must be on the first page 
of a multipage table. This argument must be a positive integer. 

You can specify the <SET_TABLE_ROW_BREAK_DEFAULT> tag anywhere in an 
SDML file. The value you specify using this tag will affect subsequent 
tables imtil the next occurrence of the tag or until the end of the file. 

related tags 

• <TABLE_R0W_BREAK> 


DESCRIPTION The <SET_TABLE_ROW_BREAK_DEFAULT> tag Overrides the default value for 

a multipage table’s first valid break. By default, tables are considered to 
be multipage; that is, if there is not enough room on the current page for a 
table, the table is continued onto subsequent pages, with any captions and 
headings repeated at the top of each new page. When the text formatter 
chooses places in the table at which to insert page breaks, it normally 
breaks the table between <TABLE_ROW> tags. By default, it assumes that it 
is correct to break a table between any two table rows after the first table 
row. 

You can override this default behavior in the following ways: 

• Specify the <SET_TABLE_ROW_BREAK_DEFAULT> tag to provide a default 
number of rows that must be on the first page of the table. For 
example, if you specify the <SET_TABLE_ROW_BREAK_DEFAULT>(3) tag, 
any subsequent table will not be broken until after the third row. 

• Specify the CONTROLLED argument to the <TABLE_ATTRIBUTES> tag, 
which indicates that you are going to specify, explicitly, the range 

in which the table will be allowed to break. You then must use the 
<TABLE_R0W_BREAK>(FIRST) and <TABLE_ROW_BREAK>(LAST) tags to 
indicate the first and last allowable page break points. Between these 
two tags, the table may be broken between any two <TABLE_ROW> tags. 
See the example in the description of the <TABLE_ATTRIBUTES> tag. 

• Use the KEEP argument to the <TABLE_ATTRIBUTES> tag to indicate 
that the table must not be broken across pages, unless it is longer than 
a page. See the example in the description of the <TABLE_ATTRIBUTES> 
tag. 

• Use the <VALlD_TABLE_ROW_BREAK> tag to indicate a place within a 
long table row that is an allowable break point. See the example in 
the description of the <VALID_BREAK> tag. 
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<SET TABLE ROW BREAK DEFAULT> 


• Use the <NESTED_TABLE_BREAK> tag to indicate a place in a nested 
table (a table within a table) that is an allowable break point. 

This tag has no effect for Bookreader output. 


EXAMPLE In the following example, the table consists of short, one-line items. The 

<SET_TABLE_ROW_BREAK_DEFAULT> tag indicates that this table, and any 
following it, must not be broken until after the fifth row. 

<SET_TABLE_ROW_BREAK_DEFAULT>(5) 

<TABLE> 

<TABLE_ATTRIBUTES>(SINGLE_SPACED) 

<TABLE_SETUP>(2\5) 

<TABLE_HEADS>(Code\Numeric Value) 

<TABLE_ROW>(A\l) 

<TABLE_ROW>(B\2) 


<TABLE_ROW>(Z\2 6) 
<ENDTABLE> 




<SINGLE QUOTE> 


<SINGLE_QUOTE> 

Supplies a single quotation mark as it appears on a keyboard. 

FORMAT 

<SINGLE_QUOTE> 

ARGUMENTS 

None. 

related tags 

• <DOUBLE_QUOTE> 

• <PARENDCHAR> 

• <QUOTE> 

DESCRIPTION 

The <SINGLE_QU0TE> tag supplies a single quotation mark as it appears on 
a keyboard. This is different from the single quotation mark that appears 
on your terminal screen. 

If you use the single quotation mark from your keyboard instead of the 
tag, your output will contain an unmatched closing single quotation 
mark—one half of what should be a matched pair according to typesetting 
conventions. 


EXAMPLE The following example shows how to use the <SINGLE_QU0TE> tag. The 

<PARENDCHAli> tag simply provides better spacing of the single quote 
within the parentheses. 


<P>Notice the difference between using the 
<tag>(single_quote) tag to output a single quotation mark, 
for example, <PARENDCHAR>(<SINGLE_QUOTE>), and using the 
keyboard single quotation mark, for example, <PARENDCHAR>('). 

This example produces the following output: 

Notice the difference between using the <SINGLE_QUOTE> tag to output a 
single quotation mark, for example, ('), and using the keyboard single 
quotation mark, for example, (’). 
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<SPAN> 


<SPAN> 

Specifies that the accompanying argument in a table row or a table head 
spans more than one table column. 

FORMAT 

<SPAN> (number of columns[ 1 LEFT]) 

ARGUMENTS 

number of columns 

Specifies the number of table columns that the text following the <SPAN> 
tag spans. This argument must be a whole number and must be no larger 
than the number of table columns remaining in the table row, including 
the table column in which you placed the <SPAN> tag itself. 

LEFT 

This is an optional keyword argument. It specifies that the text of the 
argument be aligned to the left-most position of the spanned columns. If 
you do not use this argument, the text of the argument is centered in the 
spanned columns. 

related tags 

• <RULE> 

• <TABLE_HEADS> 

• <TABLE_UNIT_HEADS> 

restrictions 

Valid only in an argument to a <TABLE_ROW>, <TABLE_HEADS>, or 
<TABLE_UNIT_HEADS> tag. 

Must immediately precede the argument text. 

DESCRIPTION 

The <SPAN> tag specifies that the accompanjdng argument in a table row 
or a table head spans more than one table column. The text is displayed 
without regard to the gutter that separates the columns. The text is 
centered in the spanned columns, unless you specify the LEFT argument. 

If the text length exceeds the width of the spanned columns, it is broken at 
a word boundary and displayed on additional table lines. Any additional 
lines of text are centered or aligned against the left margin to agree with 
the alignment of text in the first line. 

Use the <RULE> tag if you want to place a rule beneath a spanned heading 
created using the <SPAN> tag. 
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<SPAN> 


EXAMPLES The following example shows how to use the <SPAN> tag to center the table 

heading over three columns. It also shows how to use the LEFT ke5rword 
to position a table unit heading to the left-most position of the spanned 
columns. Note the use of the <RULE> tag in this example. 


Q <TABLE> 

<TABLE_SETUP>(3\12\12) 

<TABLE_HEADS>(<SPAN>(3)Types of Ancient Weaponry) 
<TABLE_UNIT> 

<TABLE_UNIT_HEADS>(Polearms) 

<TABLE_ROW>(Spear\Javelin\Halberd) 

<ENDTABLE_UNIT> 

<TABLE_UNIT> 

<TABLE_UNIT_HEADS>(Maces\<SPAN>(2\LEFT)Swords<RULE>) 
<TABLE_UNIT_HEADS>( \Short swords\Long swords) 
<TABLE_ROW>(Great Mace\Gladius\Great Sword) 
<ENDTABLE_UNIT> 

<ENDTABLE> 


This example produces the following output: 


Types of Ancient Weaponry 

Polearms 

Spear 

Javelin 

Halberd 

Maces 

Swords 


Short swords 

Long swords 

Great Mace 

Gladius 

Great Sword 


In the following example, notice how using the <SPAN> tag in this way 
centers “Small Fixture” correctly. 


§ <table> 

<table_setup>(5\9\9\9\9) 

<table_row>(\<span>(2)Small Fixture\<span>(2)Large Fixture) 
<table_row>(Component\Minimum\Maximum\Minimum\Maximum) 
<endtable> 


Notice, however, that “Large Fixture” may be too far to the right, as in the 
following example: 


Component 


Small Fixture 
Minimum Maximum 


Minimum 


Large Fixture 
Maximum 




<SPAN> 


This occurs because the <SPAN> tag attempts to span the last column to the 
margin. To fix this problem, code the table to specify an additional column 
and specify a width for the next to last column, thereby limiting the 
distance that is spanned. The following is an example of such a correction: 

<table> 

<table_setup>(6\8\8\8\8\8) 

<table_row>(\<span>(2)Small Fixture\<span>(2)Large Fixture) 
<table_row> (Component\Minimum\Maximum\Minimum\Maximum) 

<endtable> 

This example produces the following output: 

Small Fixture Large Fixture 

Component Minimum Maximum Minimum Maximum 
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<SPECIAL CHAR> 


<SPECIAL_CHAR> 

Provides access to special characters that are not available on the terminal 
keyboard. 


FORMAT <SPECIAL_CHAR>f/ceyivordj 


ARGUMENTS keyword 

Specifies a keyword associated with the special character you want to 
produce in your output file. The character is always a non-math character. 
The following are valid ke 5 nvords: 


Keyword 

Character 

CLOSE_DOUBLE_BRACKET 

1 

DAGGER 

t 

DOUBLE_DAGGER 

* 

DOUBLE_HYPHEN 

“ 

FULL_D1AM0ND 

♦ 

OPEN_DOUBLE_BRACKET 

tt 

REGISTERED_SYMBOL 

® 

SECTI0N_S1GN 

§ 

TRADEMARK_SYMBOL 

TM 


related tags • <math_char> 

• <MCS> 


DESCRIPTION The <SPECIAL_CHAR> tag provides access to special characters that are not 

available on the terminal keyboard. 

You can use the <SUBSCRIPT> and <SUPERSCRIPT> tags with the <SPECIAL_ 
CHAR> tag to get subscripted and superscripted characters. For example, 
you can enter the following code to get a superscripted registered symbol: 

<SUPERSCRIPT>(<SPECIAL_CHAR>(REGISTERED_SYMBOL)) 
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<SPECIAL CHAR> 


EXAMPLE In the following example, the special character ♦ is used in an example of 

terminal output to show that text wraps at the end of a line. 

%COPY-I-COPIED, $DISK1;[MYDIRECTORY]MYFILE,PLI;5 

<tag>(special_char)(FULL_DIAMOND) 

copied to $DISK1:[YOURDIRECTORY]YOURFILE.PLI;5 

This example produces the following output: 

%COPY-I-COPIED, $DISK1:[MYDIRECTORY]MYFILE.PLI;5 

♦ 

copied to $DISK1:[YOURDIRECTORY]YOURFILE.PLI;5 
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<SUBHEADn> 


<SUBHEADn> 


Marks an unnumbered subsidiary heading. 


FORMAT <SUBHEADn>f/7eacf/n£r text[\symbol name}) 


ARGUMENTS heading text 

Specifies the text of the subsidiary heading. 

symbol name 

This is an optional argument. It specifies the name of the symbol 
used in all references to this heading. Sjmibol names must not exceed 
31 characters and must only contain alphabetic letters, numbers, or 
underscores. Do not begin a symbol name with an underscore. 


related tags • <chead> 

• <HEAD1> through <HEAD6> 


DESCRIPTION The <SUBHEADl> and <SUBHEAD2> tags mark an unnumbered subsidiary 

heading. You are allowed only two levels of subheadings. Each reflects a 
logical hierarchy within the structure of the text. 

These subheadings are not numbered and do not appear in the table of 
contents. They cannot be readily used for cross-references and you should 
use them only when the clarity of your exposition requires such a fine level 
of distinction. 

In some doctypes, the distinction is made between the <SUBHEADl> and 
<SUBHEAD2> tags by making the <SUBHEAD2> tag a run-in heading. This 
means that the following text begins on the same line as the subheading. 
The doctype controls the text formatter’s placement of the text following 
the <SUBHEAD2> tag. Whether or not you expect the heading to be run-in, 
always tag the text element following the heading (for example, always 
mark a paragraph with a <P> tag). 


EXAMPLE The following example shows how to use the <SUBHEADn> tag. 

<SUBHEAD1>(Using a Subhead\use_of_subhead) 

<P>The use of subheads should be restricted to occasions when the clarity 
of your exposition absolutely requires one. 

This example produces the following output: 

Using a Subhead 

The use of subheads should be restricted to occasions when the clarity of 
your exposition absolutely requires one. 
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<TABLE> 


<TABLE> 

Begins a sequence of columnar data. 

FORMAT 

<TABLE>[(table caption[\ symbol name])] 

ARGUMENTS 

table caption 

This is an optional argument. It specifies the text of the caption to be 
associated with the table. Using this argument indicates that the table is 
a formal table, because the table has a number and a caption and is listed 
in the table of contents. If you do not specify a table caption argument, the 
table is considered an informal table, because it has no number or caption 
and is not listed in the table of contents. 


If the body of the table spans more than a single page of text, the table 
caption is repeated on each page on which the table continues. 


symbol name 

This is an optional argument. It specifies the symbolic identifier to be 
associated with the table. The symbol is assigned a numeric value, which 
is the current table number. The symbol and its value are placed in the 
symbol table. 


S 3 mbol names must not exceed 31 characters and must only contain 
alphabetic letters, numbers, or underscores. Do not begin a symbol name 
with an underscore. 


related tags • <align_chae> 

• <ALIGN_NUMBER> 


<NESTED_TABLE_BREAK> 

<REFERENCE> 

<RULE> 

<SPAN> 

<TABLE_ATTRIBUTES> 

<TABLE_FILE> 

<TABLE_HEADS> 

<TABLE_KEY> 

<TABLE_KEYREF> 

<TABLE_ROW> 

<TABLE_ROW_BREAK> 

<TABLE_SETUP> 

<TABLE_SPACE> 
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<TABLE> 


• <TABLE_UNIT> 

• <TABLE_UNIT_HEADS> 

• <VALID_TABLE_ROW_BREAK> 


rOStrictionS invalid in the context of an <EXAMPLE>, <FOOTNOTE>, <MATH>, or <FIGURE> 

tag. 


required <endtable> 

terminator 


DESCRIPTION The <TABLE> tag begins a sequence of columnar data, A formal table has 

a number and a caption, can be cross-referenced, and is listed in the table 
of contents. An informal table does not have a number or a caption, 
cannot be cross-referenced, and is not listed in the table of contents. 

Note the following when processing a book for Bookreader display: 

• You must use the symbol name argument to process a formal table for 
Bookreader display. 

• DOCUMENT automatically creates pop-up windows for all formal 
tables. 

• When introducing and cross-referencing a formal table, you must use 
the <REFERENCE> tag to create a hotspot. Hotspots are regions in 
the windows you click on with your mouse to access cross-referenced 
topics. 

• You can use the <ONLlNE_POPUP> tag if you want to make informal 
tables pop up. 

• Remember that coding a table for printed output may not be suitable 
for Bookreader output, because the Bookreader’s window is narrower 
than a printed page and the Bookreader’s font size is bigger. 


EXAMPLES The following example shows how to produce a two-column table. 

Q <TABLE>(Rules for Determining Expression Modes\express_modes_tab) 
<TABLE_ATTRIBUTES>(MULTIPAGE) 

<TABLE_SETUP>(2\33) 

<TABLE_HEADS>(Expression\Value Type) 

<TABLE_ROW>(String valueXString) 

<TABLE_ROW> (Integer lexical function\Integer) 

<TABLE_ROW_BREAK>(first) 

<TABLE_ROW>(Integer symbol\Integer) 

<TABLE_ROW>(String symbol\String) 

<ENDTABLE> 


This example produces the following output: 
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<TABLE> 


Table n-n Rules for Determining Expression Modes 


Expression 

Value Type 

String value 

String 

Integer lexical function 

Integer 

Integer symbol 

Integer 

String symbol 

String 


The following example shows how to code a nested table. 

§ <TABLE>(Food Combining Workshop\schedule_tab) 

<TABLE_SETUP>(2\10) 

<TABLE_HEADS>(DayXSchedule ) 

<TABLE_ROW>(Monday\<TABLE> 

<TABLE_SETUP>(2\8) 

<TABLE_ROW>(Morning\Review Workshop Objectives) 
<TABLE_ROW>(AfternoonXStudy Protein Groups) 

<TABLE_ROW>(EveningXStudy Minerals) 

<ENDTABLE>) 

<TABLE_ROW>(Tuesday\<TABLE> 

<TABLE_SETUP>(2\8) 

<TABLE_ROW>(MorningXStudy Fruit Groups) 

<TABLE_ROW>(AfternoonXStudy Vegetable Groups) 
<TABLE_ROW>(EveningXCombining Food Groups) 

<ENDTABLE>) 

<TABLE_ROW>(WednesdayX<TABLE> 

<TABLE_SETUP>(2X8) 

<TABLE_ROW>(MorningXPoultry and Fish Diets) 

<TABLE_ROW>(AfternoonXSpecial Diets) 

<TABLE_ROW>(EveningXClosing Remarks) 

<ENDTABLE>) 

<ENDTABLE> 


This example produces the following output; 


Table n-n Food Combining Workshop 


Day 

' Schedule 


Monday 

Morning 

Review Workshop Objectives 


Afternoon 

Study Protein Groups 


Evening 

Study Minerals 

Tuesday 

Morning 

Study Fruit Groups 


Afternoon 

Study Vegetable Groups 


Evening 

Combining Food Groups 

Wednesday 

Morning 

Poultry and Fish Diets 


Afternoon 

Special Diets 


Evening 

Closing Remarks 
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<TABLE ATTRIBUTES> 


<TABLE ATTRIBUTES> 


Specifies special formatting for a table. 


FORMAT 

<TABLE_ATTRIBUTES>f/ce>wo/-d-r 

[\ keyword-2]...[\ keyword-5]) 

ARGUMENTS keyword-1 ...keyword-5 

Specifies at least one and as many as five keywords to indicate special 
formatting for the table. These keywords are listed in the following table. 

Keyword 

Description 

CONTROLLED 

Overrides the settings created by using the <SET_TABLE_ROW_BREAK_DEFAULT> tag. 
Also, indicates, for a multipage table, that the table page breaking is under explicit control of 
<TABLE ROW BREAK> tags. When you use the CONTROLLED keyword, it enables the 
<TABLE_ROW_BREAK>(FIRST) and <TABLE_ROW_BREAK>(LAST) tags to indicate the 
first and last allowable page break points. Between these two tags, the table may be broken 
between any two <TABLE_ROW> tags. 

You cannot use this keyword with the KEEP keyword. 

CONTROLLED has no effect for Bookreader output. 

KEEP 

Indicates that the table must be kept on one page. If there is not enough room on the 
current page, a new page is output. If the table exceeds the length of a page, the text 
formatter issues a warning message and not all the table is output. 

You cannot use this keyword with the MULTIPAGE keyword. 

KEEP has no effect for Bookreader output. 

MAXIMUM 

Indicates that the text of the table is adjusted to a smaller point size in order to fit within 
the left and right margins of the page. If you do not specify this argument, and if a table is 
determined during text formatting to be too wide, the text formatter will adjust the size of the 
text automatically. 

MULTIPAGE 

Indicates that the table is either of the following: 

• Longer than a page 

• Allowed to break across pages 

This is the default. If you specify MULTIPAGE, you can use the <TABLE_ROW_BREAK> 
tag to control page breaks. When a formal table is continued, the table number and caption 
(with the text “Cont’d”) and column headings are automatically repeated on subsequent 
pages. When an informal table is continued, the column headings are repeated on 
subsequent pages. 

MULTIPAGE has no effect for Bookreader output; however, a long table in a pop-up window 
repeats the column headings after you scroll past each Bookreader page. 

You cannot use this keyword with the KEEP keyword. 

SINGLE_SPACED 

Specifies that the rows in the table be single-spaced; that is, there will be no more vertical 
space between lines of different table rows than there are between lines within the same 
table row. 
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<TABLE ATTRIBUTES> 


Keyword 

Description 

WIDE 

Specifies that the width of the table exceeds the document’s default width for text. 

Depending on the doctype, this argument is interpreted as follows: 

• If the doctype contains a left margin area that is normally used for headings, the table’s 
width spans that area as well as the normal text area. 

• If the document uses a multicolumn format, the table suspends multicolumn output while 
the table is processed. The table is output across two columns and then multicolumn 
output is restored. 


related tags * <table> 

• <TABLE_SETUP> 


restrictions 

• Valid only in the context of a <TABLE> tag. 

• Must precede the <TABLE_SETUP> tag. 

• WIDE and MAXIMUM might not produce error-free output for 
monospaced output devices. 


DESCRIPTION The <TABLE_ATTRIBUTES> tag specifies special formatting for a table. 


EXAMPLES The following example uses the KEEP and WIDE attributes. 

Q <TABLE>(Equivalence Names for Default Process Logical Names\equiv_names_proc_tab) 
<TABLE_ATTRIBUTES>(WIDE\KEEP) 

<TABLE_SETUP>(4\8\10\12) 

<TABLE_HEADS>(Logical Name\Interactive\Batch\Command Procedure) 

<TABLE_ROW>(SYS$COMMAND\Terminal\Disk\Terminal) 

<TABLE_ROW>(SYS$DISK\Disk\Disk\Disk) 

<TABLE_ROW>(SYS$INPUT\Terminal\Disk\Disk) 

<TABLE_ROW>(SYS$ERROR\Terminal\Log file\Terminal) 

<TABLE_ROW>(SYS$LOGIN\Directory\Directory\Directory) 

<TABLE_ROW>(SYS$NET\\\) 

<TABLE_ROW>(SYS$OUTPUT\Terminal\Log file\Terminal) 

<TABLE_ROW>(SYS$SCRATCH\Directory\Directory\Directory) 

<TABLE_ROW>(TT\Terminal\Null device\Terminal) 

<ENDTABLE> 
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This example produces the following output: 







<TABLE ATTRIBUTES> 


Table n-n Equivalence Names for Default Process Logical Names 


Logical Name 

Interactive 

Batch 

Command Procedure 

SYS$COMMAND 

Terminal 

Disk 

Terminal 

SYS$DISK 

Disk 

Disk 

Disk 

SYS$!NPUT 

Terminal 

Disk 

Disk 

SYS$ERROR 

Terminal 

Log file 

Terminal 

SYS$LOGIN 

SYS$NET 

Directory 

Directory 

Directory 

SYS$OUTPUT 

Terminal 

Log file 

Terminal 

SYS$SCRATCH 

Directory 

Directory 

Directory 

TT 

Terminal 

Null device 

Terminal 


a 

Table n-n 

The same example, but with the MAXIMUM attribute, produces the 
following output: 

Equivalence Names for Default Process Logical Names 

Logical Name 

Interactive 

Batch 

Command Procedure 

SYS$COMMAND 

Terminal 

Disk 

Terminal 

SYS^DISK 

Disk 

Disk 

Disk 

SYS$INPUT 

Terminal 

Disk 

Disk 

SYS$ERROR 

Terminal 

Log file 

Terminal 

SYS$LOGIN 

Directory 

Directory 

Directory 

SYS$NET 




SYS$OUTPUT 

Terminal 

Log file 

Terminal 

SYS$SCRATCH 

Directory 

Directory 

Directory 

TT 

Terminal 

Null device 

Terminal 


The same example, but with the SINGLE_SPACED attribute, produces the 
following output: 


Table n-n Equivalence Names for Default Process Logical Names 


Logical Name 

Interactive 

Batch 

Command Procedure 

SYS$COMMAND 

Terminal 

Disk 

Terminal 

SYS$DISK 

Disk 

Disk 

Disk 

SYS$INPUT 

Terminal 

Disk 

Disk 

SYS$ERROR 

Terminal 

Log file 

Terminal 

SYS$LOGIN 

SYS$NET 

Directory 

Directory 

Directory 

SYS$OUTPUT 

Terminal 

Log file 

Terminal 

SYS$SCRATCH 

Directory 

Directory 

Directory 

TT 

Terminal 

Null device 

Terminal 
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<TABLE_ATTRIBUTES> 


The following example shows how to code a two-column table using the 
CONTROLLED attribute to the <TABLE_ATTRIBUTES> tag, along with the 
<TABLE_ROW_BREAK>(FlRST) and <table_ROW_BREAE:>(LAST) tags, to override 
the settings created with the <set_table_row_bREAK_default> tag. 

Suppose this table is the first of five tables in a single SDML file. You have 
set the table row break default to be 3 (using the <SET_TABLE_ROW_BREAK_ 
DEFAULT> tag). Only for this first table, moreover, you want to explicitly 
control the table page breaks (instead of the table breaks being allowed 
only after the third table row), so you allow them after the eighth and 
before the fourteenth rows using the <TABLE_ATTRlBUTES>(CONTROLLED), 
<TABLE_ROW_BREAK>(FIRST), and <TABLE_ROW_BREAK>(LAST) tags. After this 
table ends, the <SET_TABLE_ROW_BREAK_default>(3) tag takes effect again 
for the next four tables. 

gj <SET_TABLE_ROW_BREAK_DEFAULT> (3) 

<TABLE> (Rules for Determining Expression Modes\express_mod.es_tab) 

<TABLE_ATTRIBUTES>(MULTIPAGE\CONTROLLED) 

<TABLE_SETUP>(2\43) 

<TABLE_HEADS> (ExpressionWalue Type) 

<TABLE_ROW>(Integer value\Integer) 

<TABLE_ROW>(String value\String) 

<TABLE_ROW>(Integer lexical function\Integer) 

<TABLE_ROW>(String lexical function\String) 

<TABLE_ROW>(Integer symbol\Integer) 

<TABLE_ROW>(String symbolNString) 

<TABLE_ROW>(Any value .AND. or .OR. any value\Integer) 

<TABLE_ROW> (Any valueMnteger) 

<COMMENT>(Break after this) 

<TABLE_ROW_BREAK>(first) 

<TABLE_ROW> (Any valueMnteger) 

<TABLE_ROW> (Integer valueMnteger) 

<TABLE_ROW>(String value\String) 

<TABLE_ROW> (Integer lexical functionMnteger) 

<TABLE_ROW>(String lexical function\String) 

<COMMENT>(Do not break after this) 

<TABLE_ROW_BREAK>(last) 

<TABLE_ROW> (Integer symbolMnteger) 

<TABLE_ROW>(String symbolXString) 

<TABLE_ROW> (Any value .AND. or .OR. any valueMnteger) 

<TABLE_ROW> (Any valueMnteger) 

<TABLE_ROW> (Any valueMnteger) 

<ENDTABLE> 
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<TABLE FILE> 


<TABLE_FILE> 

Causes a separate file containing a formal table to be included in the SDML 
input file. 

FORMAT 

<TABLE FILE>('( b 

“ ^ \ logical name }' 

ARGUMENTS 

file spec 

Specifies the file specification of the file to be included. 

logical name 

Specifies the logical name of the file to be included. You can define a 
logical name in your profile using an <INCLUDES_FILE> tag. If you do not 
define the logical name in the profile with the <includes_file> tag, be 
sure you define the logical name elsewhere before processing the file with 
VAX DOCUMENT. 

related tags 

• <TABLE> 

restrictions 

Valid only in the context of a <TABLE> tag. 

DESCRIPTION 

The <TABLE_FILE> tag causes a separate file containing a formal table to be 
included in the SDML input file. (It is identical in action to the <INCLUDE> 
tag.) The included file should be an SDML file containing a completely 
coded table. 

By keeping a table in a separate SDML file, you can include the table in 
more than one document, or in chapters of the same document, without 
having to reproduce the code. In each location, the table is given a 
different number. 

EXAMPLES 

The following example shows how to use the <TABLE_FILE> tag to include 
a vsdde table that is contained in a separate file, called STANDARD 
FILETYPES.SDML. 

Note that the included table file will not process individually. It will 
only process when you include it in another SDML file that specifies the 
<TABLE> and <ENDTABLE> tags. 








<TABLE FILE> 


Q <TABLE>(Default VMS File Types\stand_filetypes_tab) 
<TABLE_ATTRIBUTES>(wide) 

<TABLE_FILE>(standard_filetypes.sdml) 

<ENDTABLE> 


In the following example, the file ENDLIST.SDML contains all the tags 
required for the table. 


§ <REFERENCE>(command_sum_tab) lists all the commands. 
<TABLE_FILE>(endlist.sdml) 

The tags in ENDLIST.SDML are: 

<TABLE>(Command Summary\command_sum_tab) 
<TABLE_ATTRIBUTES>(Multipage) 
<TABLE_SETUP>(2\18) 

<TABLE_HEADS>(Command\Description) 

<TABLE ROW>( ... ) 


<ENDTABLE> 

This example assumes that the table is being used in only one document. 
Placing the table in a separate file allows you to process it individually, or 
in the context of the file in which it occurs. 
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<TABLE HEADS> 


<TABLE_HEADS> 


Specifies column headings for each column in the table. 

FORMAT 

<TABLE_HEADS>fco/ heading-1 

[ I col heading-2...[ I col heading-9]]) 

ARGUMENTS 

col heading 

Specifies the heading for each column; the first argument is the heading 
for the first column. You can specify up to nine column headings. 

related tags 

• <RULE> 


• <SPAN> 


• <TABLE> 

restrictions 

• Valid only in the context of a <TABLE> tag. 

• Invalid in the context of a <TABLE_UNIT> tag. 

DESCRIPTION 

The <TABLE_HEADS> tag specifies column headings for each column in the 
table. It is not required in a table tags sequence, however. 


A heading can be any length, and is automatically formatted correctly on 
one or more lines. 


Within tables, you can use the <TABLE_HEADS> tag to specify multipage 
headings for a table. You can also use it to place new headings in the 
middle of a table. You cannot use the tag, however, in a table unit. 

EXAMPLE 

The following example shows how to use the <TABLE_HEADS> tag to produce 
a two-column table. Notice that you can use the <TABLE_HEADS> tag both 
at the top of the table to establish the headings, and also in the middle of 
the table to change the headings. 


<TABLE>(Rules for Determining Expression Modes\express_modes_tab) 
<TABLE_ATTRIBUTES>(WIDE\MULTIPAGE) 

<TABLE_SETUP>(2\33) 

<TABLE_HEADS>(Expression\Value Type) 

<TABLE_ROW>(Integer value\Integer) 

<TABLE_ROW>(String value\String) 

<TABLE_HEADS>(Value Type\Expression) 

<TABLE_ROW>(IntegerXInteger lexical function) 

<TABLE_ROW>(StringXString lexical function) 

<TABLE_ROW>(IntegerXInteger symbol) 

<TABLE_ROW>(StringXString symbol) 

<ENDTABLE> 
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<TABLE HEADS> 


This example produces the following output: 


Table n-n Rules for Determining Expression Modes 


Expression 

Value Type 

Integer value 

Integer 

String value 

String 

Value Type 

Expression 

Integer 

Integer lexical function 

String 

String lexical function 

Integer 

Integer symbol 

String 

String symbol 
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<TABLE KEY> 


<TABLE_ 

.KEY> 

Begins a key or legend for a table. 

FORMAT 

<TABLE_KEY> 

ARGUMENTS "one. 

related tags 

• <FOOTNOTE> 


• <TABLE> 


• <TABLE_KEYREF> 


• <TABLE_SETUP> 

restrictions 

Valid only in the context of a <TABLE> tag. 


Must appear immediately after the <TABLE_SETIJP> tag, either before or 
after any <FOOTNOTE> tags. 

When you use a <TABLE_KEY> tag, the number of possible footnotes for the 
same table is reduced from 12 to 11. 

The tags that you can use between the <TABLE_KEY> and <ENDTABLE_KEY> 
tags are restricted to the <P>, <LIST>, and <EMPHASIS> tags. For example, 
you cannot use a <TABLE_ROW> tag within the table key. 

Invalid in a nested table (a table within a table). The <TABIJE_KEY> tag 
must follow the <TABLE_SETUP> tag for the outermost table. 


required 

terminator 

<ENDTABLE_KEY> 

DESCRIPTION 

The <TABLE_KEY> tag begins a key or legend for a table. Abbreviations or 
special terms are often used in a table, either in the column headings or in 
the entries of the table. The table may then need a key or legend printed 
below it to explain the special terms. The <TABLE_KEY> tag begins such a 
table key. 

A table key differs from a table footnote in that the table key is not 
numbered and does not refer to a callout in the table. You can declare 
only one table key for a table, whereas up to 12 footnotes are possible for 
a table that does not include a table key, or up to 11 footnotes for a table 
that does include a table key. 
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<TABLE KEY> 


Declare the table key immediately after the <TABLE_SETUP> tag that 
begins the table and before the first tag that begins the table rows. 

This placement is identical to the placement for footnotes in a table. If 
footnotes are also present, they either can precede or follow the table key 
declaration. 

Use the <table_keyref> tag to specify where you want the table key to 
be output. When the table is a multipage table and if you want the table 
key printed at the foot of any or all portions of the table, place the <TABLE_ 
KEYREF> tag anywhere in the argument list to the <TABLE_HEADS> tag. For 
a book you create for Bookreader, the table key will always appear at the 
end of the table. 

If you want the table key to be printed only on specified pages of a 
multipage table, place the <TABLE_keyref> tag in any <TABLE_ROW> tag 
that corresponds to the different pages. You may have to print your table 
before you can determine which <TABLE_ROW> tags correspond to which 
pages. 


EXAMPLE The following example shows how to use the <TABLE_KEY> tag. 

<table>(Compatability of Lock Modes\lock_tab) 

<table_attributes>(wide\keep) 

<table_setup>{7\10\5\5\5\5\5) 

<table_key> 

<emphasis>(Key to Lock Modes\bold) 

<list>(simple) 

<le>NL-Null lock 

<le>CR-Concurrent read 

<le>CW-Concurrent write 

<le>PR-Protected read 

<le>PW-Protected write 

<le>EX-Exclusive lock 

<ENDLIST> 

<endtable_key> 

<table_heads>(Mode of RequestedX 

<span>(5)Mode of Currently Granted Locks<rule>) 

<table_heads>(Lock<TABLE_KEYREF>\NL\CR\CW\PR\PW\EX) 

<table_row>(NL\Yes\Yes\Yes\Yes\Yes\Yes) 

<table_row>(CR\Yes\Yes\Yes\Yes\Yes\No) 

<table_row>(CW\Yes\Yes\Yes\No\No\No) 

<table_row>(PR\Yes\Yes\No\Yes\No\No) 

<table_row>(PW\Yes\Yes\No\No\No\No) 

<table_row>(EX\Yes\No\No\No\No\No) 

<endtable> 


This example produces the following output: 
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<TABLE KEY> 


Table n-n Compatibility of Lock Modes 


Mode of 

Requested 

Lock 

Mode of Currently Granted Locks 


NL 

CR 

CW 

PR 

PW 

EX 

NL 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

CR 

Yes 

Yes 

Yes 

Yes 

Yes 

No 

CW 

Yes 

Yes 

Yes 

No 

No 

No 

PR 

Yes 

Yes 

No 

Yes 

No 

No 

PW 

Yes 

Yes 

No 

No 

No 

No 

EX 

Yes 

No 

No 

No 

No 

No 


Key to Lock Modes 

NL—Null lock 
CR—^Concurrent read 
CW—Concurrent write 
PR—Protected read 
PW—Protected write 
EX—Exclusive lock 
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<TABLE KEYREF> 


<TABLE_KEYREF> 

Specifies that a table key be printed below the table (or any portion of a 
multipage table) in which this tag appears. 

FORMAT 

<TABLE_KEYREF> 

ARGUMENTS 

None. 

related tags 

• <TABLE_KEY> 

restrictions 

Valid only in the context of a table in which you specify the <TABLE_KEY> 
tag. 

Invalid in nested tables (a table within a table). 

You can use this tag only at the end of an argument list and you cannot 
embed it in text. The end of an argument list is indicated by a backslash 
(\) or a closing parenthesis ()). 

DESCRIPTION 

The <TABLE_KEYKEF> tag specifies that a table key be printed below the 
table (or any portion of a multipage table) in which this tag appears. The 
table key is printed only if the <TABLE_KEYIIEF> tag appears in the table. 

If you want the table key printed at the foot of all portions of a multipage 
table, place the <TABLE_KEYREF> tag an 3 nvhere in the argument list to the 
<TABLE_HEADS> tag. 

If you want the table key to be printed only on specified pages of a 
multipage table, place the <TABLE_KEYREF> tag anywhere in the argument 
list to the <TABLE_ROW> tag that corresponds to the different pages. You 
may have to print your table before you can determine which <TABLE_ROW> 
tags correspond to which pages. 

EXAMPLE 

See the example in the discussion of the <TABLE_KEY> tag. 







<TABLE ROW> 


<TABLE_ROW> 

Specifies text for each column in a table. 

FORMAT 

<TABLEJRO\N>(column text-1 

[\ column text-2...[\ column text-9]]) 

ARGUMENTS 

column text 

Specifies text for a single column in the table row. The number of 
arguments depends on the number of columns you specify for the table 
using the <TABLE_SETUP> tag; you can specify up to 9 columns. If the 
number of arguments to the <TABLE_ROW> tag exceeds the number of 
columns currently in effect for the table, the excess columns are ignored. 

If the number of arguments is less than the number of columns currently 
in effect for the table, unspecified columns are output as blanks. 

related tags 

• <ALIGN_CHAR> 

• <ALIGN_NUMBER> 

• <RULE> 

• <SPAN> 

• <TABLE> 

• <TABLE_ROW_BREAK> 

• <VALID_TABLE_ROW_BREAK> 

restrictions 

Valid only in the context of a <TABLE> tag. 

If the text in a single table row column exceeds the length of an 
output page, the text formatter issues an error message and terminates 
processing. 

You can control page breaking of long table rows, with additional 
restrictions, using the <VALID_ROW_BREAK> tag. 

DESCRIPTION 

The <TABLE_ROW> tag specifies text for each column in a table. 

EXAMPLE 

The following example shows how to use the <TABLE_ROW> tag to produce 
a two-column table. 
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<TABLE ROW> 


<TABLE>(Rules for Determining Expression Modes\express_modes_tab) 
<TABLE_ATTRIBUTES>(WIDE\MULTIPAGE) 

<TABLE_SETUP>(2\43) 

<TABLE_HEADS>(Expression\Value Type) 

<TABLE_ROW>(Integer value\Integer) 

<TABLE_ROW>(String value\String) 

<TABLE_ROW>(Integer lexical function\Integer) 

<TABLE_ROW>(String lexical function\String) 

<TABLE_ROW>(Integer symbol\Integer) 

<TABLE_ROW>(String symbol\String) 

<TABLE_ROW>(Any value .AND. or .OR. any valueXinteger) 
<TABLE_ROW>(Any valueXinteger) 

<TABLE_ROW>(Any valueXinteger) 

<ENDTABLE> 


This example produces the following output: 


Table n-n Rules for Determining Expression Modes 


Expression 

Value Type 

Integer value 

Integer 

String value 

String 

Integer lexical function 

Integer 

String lexical function 

String 

Integer symbol 

Integer 

String symbol 

String 

Any value .AND. or .OR. any value 

Integer 

Any value 

Integer 

Any value 

Integer 
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<TABLE ROW BREAK> 


<TABLE ROW BREAK> 


Specifies the boundaries in which a long table can be broken onto a new 
page. 


FORMAT 


<TABLE_ROW_BREAK>('| |j 


ARGUMENTS FIRST 

LAST 

If you use <TABLE_ATTRlBUTES>(CONTROLLED), these keyword arguments 
specify the bounds within which a multipage table may be broken. After 
you specify the <TABLE_ROW_BREAK>(FlRST) tag, any row in the table up to 
the occurrence of the <TABLE_ROW_BREAK>(LAST) tag is treated as a suitable 
page-breaking point. 


related tags 


• <NESTED_TABLE_BREAK> 

• <TABLE> 

• <table_attributes>(CONTROLLED) 

• <TABLE_UNIT> 

• <VALID_TABLE_ROW_BREAK> 


restrictions ignored in a table specified with the <TABLE_ATTRIBUTES>(KEEP) tag and in 

a nested table. 

Enabled only by the <TABLE_ATTRIBUTES>(CONTROLLED) tag. 


DESCRIPTION The <TABLE_ROW_BREAK> tag specifies the boundaries in which a long 

table can be broken onto a new page. You must, however, use the <TABLE. 
ATTRIBUTES>(CONTROLLED) tag in order for the <TABLE_R0W_BREAK> tag to 
work. The <TABLE_R0W_BREAK> tag has no effect for Bookreader output. 

Tables in VAX DOCUMENT are, by default, multipage tables. If you 
do not specify <TABLE_ROW_BREAK>(FIRST) and <TABLE_ROW_BREAK>(LAST) 
to provide the text formatter with reasonable guidelines to break tables 
across pages, the text formatter will nonetheless select page breaks. The 
page breaks selected will not always be suitable. Therefore, using the 
<TABLE_ROW_BREAK> tag is recommended. 

If the table includes long table units and you want to allow them 
to break across pages, use the <TABLE_ROW_BREAK>(FlRST) and 
<TABLE_ROW_BREAK>(LAST) tags within the bounds of each <TABLE_UNIT> 
and <ENDTABLE_UNIT> tag. 
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<TABLE ROW BREAK> 


By default, the text formatter will not break a page within a table row. 
With some restrictions, you can specify valid page breaks within table 
rows using the <VALID_TABLE_ROW_BREAK> tag. See the <VALID_TABLE_ROW_ 
BREAK> tag description for more information. 

You can give, with some restrictions, a nested table (that is, a table within 
a table) valid page breaks using the <NESTED_TABLE_BREAK> tag. See the 
<NESTED_TABLE_BREAK> tag description for more information. 


EXAMPLE The following example shows how to produce a two-column table using the 

<TABLE_ROW_BREAK>(FIRST) and <TABLE_ROW_BREAK>(LAST) tags. Note that 
you must use the CONTROLLED argument to the <TABLE_ATTRIBUTES> 
tag to enable the <table_row_break>(first) and <table_row_break>(LAST) 
tags. 

<TABLE>(Rules for Determining Expression Modes\express_modes_tab) 

<TABLE_ATTRIBUTES>(WIDE\MULTIPAGE\CONTROLLED) 

<TABLE_SETUP>(2\43) 

<TABLE_HEADS>(Expression\Value Type) 

<TABLE_ROW>(Integer value\Integer) 

<TABLE_ROW>(String value\String) 

<TABLE_ROW>(Integer lexical function\Integer) 

<COMMENT>(break after this) 

<TABLE_ROW_BREAK>(first) 

<TABLE_ROW>(String lexical function\String) 

<TABLE_ROW> (Integer symbolMnteger) 

<COMMENT>(do not break after this) 

<TABLE_ROW_BREAK>(last) 

<TABLE_ROW>(String symbol\String) 

<TABLE_ROW>(Any value .AND. or .OR. any value\Integer) 

<TABLE_ROW>(Any value\Integer) 

<TABLE_ROW> (Any valueMnteger) 

<TABLE_ROW>(Integer value\Integer) 

<TABLE_ROW>(String value\String) 

<TABLE_ROW>(Integer lexical function\Integer) 

<TABLE_ROW>(String lexical function\String) 

<TABLE_ROW> (Integer symbolMnteger) 

<TABLE_ROW>(String symbol\String) 

<TABLE_ROW> (Any value .AND. or .OR. any valueMnteger) 

<TABLE_ROW>(Any value\Integer) 

<TABLE_ROW> (Any valueMnteger) 

<ENDTABLE> 


This example produces the following output (except for Bookreader output, 
where the <TABLE_ROW_BREAK> tag has no effect): 


Table n-n Rules for Determining Expression Modes 


Expression 

Value Type 

Integer value 

Integer 

String value 

String 

Integer lexical function 

Integer 

String lexical function 

String 
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<TABLE_ROW__BREAK> 


Table n-n (Cont.) Rules for Determining Expression Modes 


Expression 

Value Type 

Integer symbol 

Integer 

String symbol 

String 

Any value .AND. or .OR. any value 

Integer 

Any value 

Integer 

Any value 

Integer 

Integer value 

Integer 

String value 

String 

Integer lexical function 

Integer 

String lexical function 

String 

Integer symbol 

Integer 

String symbol 

String 

Any value .AND. or .OR. any value 

Integer 

Any value 

Integer 

Any value 

Integer 
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<TABLE SETUP> 


<TABLE SETUP> 


Declares up to 9 columns in a table and the approximate width to be assigned 
to each column. 


FORMAT <TABLE_SETUP>(number \ width^[ ... 1 width 


ARGUMENTS number 

Specifies the number of columns in the table. Must be a numeric argument 
in the range of 2 through 9. 

widths 

l^^^^^number-1 

Specify the approximate widths of columns 1 through number — 1. Do not 
specify the width of the last column. This column occupies the space left 
between the second-to-last column and the right margin. 

The width unit is measured in characters. This is an approximate 
measurement, however, because the width of each character depends 
on the fonts being used in the doctype. You may need to modify the width 
argument after processing the table and viewing the output. 


related tags • <table> 

• <TABLE_ATTRIBUTES> 


restrictions 

• Valid only in the context of a <TABLE> tag. 

• If you do not include the <TABLE_SETUP> tag in a sequence of <TABLE> 
tags, no table is included in your output. 

• Must appear after the <TABLE_ATTRIBUTES> tag and before the <TABLE. 
ROW> tags in the table tag sequence. 


DESCRIPTION The <TABLE_SETUP> tag Declares up to 9 columns in a table and the 

approximate width to be assigned to each column. 

In the width argument, define the width of each column except the last, 
which is supplied automatically 

Values you specify in the <TABLE_SETUP> tag are checked during processing 
to determine whether the values exceed or approach the table’s limit for 
the given doctype. Warning or error messages are issued as appropriate. 

If the table column widths do not allow the table to fit within the page 
width, the text processor substitutes a smaller point size for the font in 
which the table is set. It then attempts again to fit the table within the 
text margin. 
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<TABLE SETUP> 


EXAMPLE The following example shows how to use the <TABLE_SETUP> tag. 

<TABLE>(Names of Cheeses from Around the World\cheeses_tab) 

<TABLE_ATTRIBUTES>(wide\multipage) 

<TABLE_SETUP>(4\14\14\14) 

<TABLE_HEADS>(Cheese Name\Location of Production\Type\Color) 

<TABLE_ROW>(Spreadable\Great Britain\Curdled\White) 

<TABLE_ROW>(Smooth\Switzerland\Aged and Tasty\Off yellow) 

<TABLE_ROW>(Chunky\American\Bland\Yellow) 

<ENDTABLE> 

This example produces the following output: 


Table n-n Names of Cheeses from Around the World 


Cheese Name 

Location of 
Production 

type 

Coior 

Spreadable 

Great Britain 

Curdled 

White 

Smooth 

Switzerland 

Aged and Tasty 

Off yellow 

Chunky 

American 

Bland 

Yellow 
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<TABLE SPACE> 



EXAMPLE The following example shows how to code a table with the <TABLE_SPACE> 

tag. Each <TABLE_SPACE> tag reserves space inside of the table row for a 
diagram. 


<TABLE> (Script Control Block;s\script_tab) 

<TABLE_ATTRIBUTES>(WIDE) 

<TABLE_SETUP>(2\22) 

<TABLE_HEADS>(Block ID\Layout) 

<TABLE_ROW>(SCBEG; starts the scripting sequence\<TABLE_SPACE>(4\SCBEG diagram)) 

<TABLE_ROW>(SCMID; gives the body of the script\<TABLE_SPACE>(4\SCMIDdiagram)) 

<TABLE_ROW>(SCEND; ends the scripting sequence\<TABLE_SPACE>(4\SCEND diagram)) 
<ENDTABLE> 

This example produces the following output: 
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<TABLE SPACE> 


Table n-n Script Control Blocks 


Block ID 

Layout 


SCBEG; starts the scripting 
sequence 


SCBEG diagram 

SCMID; gives the body of the 
script 


SCMID diagram 

SCEND; ends the scripting 
sequence 


SCEND diagram 
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<TABLE UNIT> 


<TABLE_UNIT> 

Begins a portion of a table containing rows that you want to group as a logical 
unit. 

FORMAT 

<TABLE_UNIT> 

ARGUMENTS 

None. 

related tags 

• <TABLE> 

• <TABLE_ROW_BREAK> 

• <TABLE_UNIT_HEADS> 

restrictions 

Valid only in the context of a <TABLE> tag. 

You must not declare the <TABLE_ATTRIBUTE> tag with the KEEP argument 
in the context of the <TABLE_UNIT> tag. 

required 

terminator 

<ENDTABLE_UNIT> 

DESCRIPTION 

The <TABLE_UNIT> tag begins a portion of a table containing rows that you 
want to group as a logical unit. You can give the table unit a heading. 

If the table units are long and you want to allow them to break across 
pages, use the <table_row_break>(FIRST) and <table_row_break>(LAST) 
tags within the bounds of each <TABLE_UNIT> and <ENDTABLE_UNIT> tag. 

EXAMPLE 

The following example shows how to use the <TABLE_UNIT> tag. 


<Table>(String Passing Techniques Used by the Run-Time Library\Str_Tech_Tab) 
<TABLE_ATTRIBUTES>(WIDE\MULTIPAGE) 

<Table_Setup>(4\20\7\10) 

<Table_Heads>(\<SPAN>(3)String Descriptor Fields<RULE>) 

<Table_Heads>(String Type\Class\Length\Pointer) 

<Table_Unit> 

<Table_Unit_Heads>(<SPAN>(4\LEFT)Input Argument to Procedures) 

<Table_Row>(Input string passed by descriptor\Read\Read\Read) 

<Endtable Unit> 
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<TABLE UNIT> 


<Table_Unit> 

<Table_Unit_Heads>(<SPAN>(4\LEFT)Output Argument from Procedures; 

Called Procedure Assumes the Descriptor Class) 

<Table_Row>(Output string passed by descriptor, 
fixed-length\Ignored\Read\Read) 

<Table_Row>(Output string passed by descriptor, dynamic\Ignored\Read, may be 
modified\Read, may be modified) 

<Endtable_Unit> 

<Table_Unit> 

<Table_Unit_Heads>(<SPAN>(4)Output Argument from Procedures, Calling Program 
Specifies the Descriptor Class in the Descriptor) 

<Table_Row>(Output string, fixed-length -DSC$K_CLASS = S, Z, A, NCA, SD 

\Read\Read\Read) 

<Table_Row>(Output string, dynamic -DSC$K_CLASS_D 

\Read\Read, may be modified\Read, may be modified) 

<Table_Row>(Output string, varying-length -DSC$K_CLASS_VS 

\Read\MAXSTRLEN is read; CURLEN is modified\Read) 

<Endtable_Unit> 

<Endtable> 


This example produces the following output: 


Table n-n String Passing Techniques Used by the Run-Time Library 





String Descriptor Fields 

String Type 

Class 

Length 

Pointer 

Input Argument to Procedures 

Input string passed by 
descriptor 

Read 

Read 

Read 

Output Argument from Procedures; Called Procedure Assumes the Descriptor Class 

Output string passed by 
descriptor, fixed-length 

Ignored 

Read 

Read 

Output string passed by 
descriptor, dynamic 

Ignored 

Read, may be 
modified 

Read, may be modified 

Output Argument from Procedures, Calling Program Specifies the Descriptor Class in the Descriptor 

Output string, fixed-length 
—DSC$K CLASS = S, Z, A, 
NCA, SD 

Read 

Read 

Read 

Output string, dynamic 
—DSC$K_CLASS_D 

Read 

Read, may be 
modified 

Read, may be modified 

Output string, varying-length 
—DSC$K_CLASS_VS 

Read 

MAXSTRLEN 
is read; 
CURLEN is 
modified 

Read 
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<TABLE UNIT HEADS> 


<TABLE_UNIT_HEADS> 

Specifies headings you want to use for a table unit. 

FORMAT 

<TABLE_UNIT_HEADS> (col heading-1 

[ I col heading-2...[ I col 
heading-9]]) 

ARGUMENTS 

col heading 

Specifies the text for the heading for each column. The first argument is 
the heading for the first column. You can specify up to nine arguments, 
depending on the number of columns in the table. 

related tags 

• <RULE> 

• <SPAN> 

• <TABLE_UNIT> 

restrictions 

Valid only in the context of a <TABLE_UNIT> tag. 

Must immediately follow the <TABLE_UNIT> tag. 

DESCRIPTION 

The <TABLE_UNIT_HEADS> tag specifies headings you want to use for a table 
unit. The number of column headings depends on the number of columns 
in the table, as determined by the <TABLE_SETUP> tag. 

Often, the heading for a table unit is used to supply a single heading that 
spans the columns of the table and serves to label the table unit, rather 
than the individual columns. In this case, supply an argument that begins 
with the <SPAN> tag. 

A null argument leaves the corresponding table column blank. 

You can supply more than one <TABLE_IJNIT_HEADS> tag following a 
<TABLE_UNIT> tag. 
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<TABLE UNIT HEADS> 


When the heading text for a table column requires multiple lines, you can 
do the following: 

• Supply the text as a long argument to a single <TABLE_UNIT_HEADS> 
tag. The text is automatically displayed on the required number of 
lines. 

• Supply the text of the heading as shorter arguments to successive 
<TABLE_UNIT_HEADS> tags. In this way, you can control how the text is 
displayed on successive lines of the heading. 

If a page break occurs in the table unit, all lines of the table unit heading 
are repeated at the top of the next page. 


EXAMPLE 


See the example in the discussion of the <TABLE_UNIT> tag. 




<TAG> 


<TAG> 

Labels a tag and its arguments. 

FORMAT 

<TAG> (tag name[\ tag arg-1 ... /I tagarg-8]]) 

ARGUMENTS 

tag name 

Specifies the name of the tag. 

tagarg 

This is an optional argument. It specifies an argument to the tag. The 
number of arguments you specify depends on the number of arguments 
available to the tag you are labeling. 

related tags 

• <LITERAL> 

restrictions 

Invalid in the context of a <MATH> tag. 

DESCRIPTION 

The <TAG> tag labels a tag and its arguments. 

EXAMPLES 

The following example shows how to use the <TAG> tag. 


Q <P>You use the <TAG>(p) tag to begin a new paragraph. 

This example produces the following output: 

You use the <P> tag to begin a new paragraph. 

The following example shows how to use the <TAG> tag with an argument. 

§ Use the <TAG>(code_example\WIDE) tag if your example 
has long lines. 


This example produces the following output: 

Use the <C0DE_EXAMPLE>(WIDE) tag if your example has long lines. 

The following example shows the difference in output caused by the <TAG> 
tag and the <LITERAL> tag. 

§ A writer can use the <tag>(line_art) tag to label a rough sketch. A writer 
should not use the <literal><icon><endliteral> tag for that purpose. 

This example produces the following output: 

A writer can use the <LINE_ART> tag to label a rough sketch. A writer 
should not use the <icon> tag for that purpose. 







<TITLE> 


<TITLE> 

Labels the title used on either a title page or part page. (A part page is a 
divider page for a new part of a document.) 

FORMAT 

<TITLE>('f/f/e line-1 [\ title line-2[\ title iine-3]]) 

ARGUMENTS 

title line-n 

Specifies one to three separate lines of text for the title. 

related tags 

• <PART_PAGE> 

• <TITLE_PAGE> 

restrictions 

Valid only in the context of a <PART_PAGE> or a <TITLE_PAGE> tag. 

Must appear immediately after the <PART_PAGE> or <TITLE_PAGE> tag. 

The <RIGHT_LINE> and <CENTER_line> tags are invalid within an argument 
to the <TITLE> tag. 

Accepts only two title line arguments when used within a part page or in 
the SOFTWARE.BROCHURE doctype. 

DESCRIPTION 

The <TITLE> tag labels the title used on either a title page or part page. (A 
part page is a divider page for a new part of a document.) 

On a part page, the <TITLE> tag accepts one or two title text arguments, 
and the title text is kept on the same line. 

In the SOFTWARE.BROCHURE doctype, the <TITLE> tag accepts one 
or two title text arguments. If you specify only the first argument, the 
title text is placed at the top of the first page and at the bottom of each 
successive page; if you also specify the optional second argument, that 
title text is placed at the bottom of each page. The title text placed at 
the bottom of the page by the SOFTWARE.BROCHURE <TITLE> tag will 
be overridden by the text argument of any subsequent <CHAPTER> tags. 
Refer to VAX DOCUMENT Using Doctypes and Related Tags for more 
information on using the tag in the SOFTWARE.BROCHURE doctype. 

EXAMPLE 

See the example in the discussion of the <FRONT_MATTER> tag. 
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<TITLE PAGE> 



DESCRIPTION The <TITLE_PAGE> tag labels the beginning of a title page and enables the 

following title page tags: 

• <ABSTRACT> 

• <ORDER_NUMBER> 

• <REVISION_INFO> 

• <TITLE> 

DOCUMENT considers the title page to be an online topic. See VAX 
DOCUMENT Producing Online and Printed Documentation for more 
information about online topics. 

Your Bookreader document must contain a title page with the <TITLE_ 
PAGE> and <ENDTITLE_PAGE> tags. The <FRONT_MATTER> tag and the LMF 
(License Management Facility) tags must appear before the <TITLE_PAGE> 
tag. Do not place any tags that generate text before the <TITLE_PAGE> tag. 

EXAMPLE See the example in the discussion of the <FRONT_MATTER> tag. 
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<u> 


<u> 

Labels the user portion of a dialog between user and system in an interactive 
example. 

FORMAT 

<\}>(text) 

ARGUMENTS 

text 

Specifies the text of the user input. 

related tags 

• <INTERACTIVE> 

• <S> 

DESCRIPTION 

The <U> tag labels the user portion of a dialog between user and system 
in an interactive example. You must identify both parts of an example 
containing this type of dialog in order to differentiate the two types of text 
in the source code, the output, or both. In Bookreader output, the text that 
you label with the <U> tag appears in boldface. 

In the SOFTWARE doctype, you can use the <U> and <S> tags to 
differentiate the system and user text inside of examples created with 
the <EXAMPLE_SEQUENCE> and <EXI> tags. For more information on this 
doctype, refer to VAX DOCUMENT Using Doctypes and Related Tags. 

EXAMPLES 

The following example shows how to use the <U> tag. 


Q <P>The user prompt <U>(send) indicates you can send a command. 


This example produces the following output: 

The user prompt send indicates you can send a command. 

The following example shows how to code dialog between both the system 
and the user. In a dialog, the <S> and <U> tags must be used between 
<INTERACTIVE> and <ENDINTEEACTIVE> tags. Note that you should specify, 
within the argument to the <S> tag, whatever space follows the system 
prompt. 

§ <P>The following example of VAXMAIL contains messages from both 
the system and a user of the system: 

<INTERACTIVE> 

<U>(mail) 

<S>(MAIL> )<U>(send) 

<S>(To: )<U>(nodename::Courtney) 

<S>(%MAIL-E-NOSUCHUSR, no such user COURTNEY at node NODENAME) 

<ENDINTERACTIVE> 

This example produces the following output: 
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<u> 


The following example of VAXMAIL contains messages from both the 
system and a user of the system: 

mail 

MAIL> send 

To: nodename:;Courtney 

%MAIL-E-NOSUCHUSR, no such user COURTNEY at node NODENAME 
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<UNDERLINE> 


<UNDERLINE> 


Marks a portion of text you want uniierlined. 

FORMAT 

<UNDERLINE>ffexy 

or 

<UNDERLINE> 

text 


<ENDUNDERLINE> 

ARGUMENTS 

text 

Specifies the text string you want to underline. 

restrictions 

Because the text string that is marked for underlining is kept on the same 
line in the output, do not make the underline longer than the page width, 
or errors may be generated. 

required 

terminator 

<ENDUNDERLINE> — Required if you do not specify the text argument to 
the <UNDERLINE> tag. 

DESCRIPTION 

The <UNDERLINE> tag marks a portion of text you want underlined. 


EXAMPLES The following example shows how to use the <UNDERLINE> tag with an 

argument. 


Q <P>If you use the appropriate flags, your output 
may look like this: 

<P> 

<SAMPLE_TEXT> 

<UNDERLINE>(The Decline and Fall of the Roman Empire) 
<ENDSAMPLE TEXT> 


This example produces the following output: 

If you use the appropriate flags, your output may look like this: 


The Decline and Fall of the Roman Empire 
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<UNDERUNE> 


The following example shows how to use the <UNDERLINE> tag with the 
<ENDUNDERLINE> tag. This example produces the same output as the first 
example. 


<P>If you use the appropriate flags, your output 
may look like this: 

<P> 

<SAMPLE_TEXT> 

<UNDERLINE>The Decline and Fall of the Roman Empire<ENDUNDERLINE> 
<ENDSAMPLE TEXT> 
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<UPDATE RANGE> 


<UPDATE_ 

RANGE> 

Marks the location at which a new section of updated pages begins. 

FORMAT 

<UPDATE_RANGE>('sfartpagfel S^^dpage 

ARGUMENTS 

start page 

Specifies the page number from the printed documentation of the first 
updated page you want to print. 

end page 

Specifies the last page to be included in a set of update pages. VAX 
DOCUMENT automatically generates point-numbered pages if text within 
the bounds of the <update_range>(STAET page) and <update_range>(END 
PAGE) tags will not fit within those pages. 

EOF 

This ke3rword specifies that the update range continues to the end of a 
chapter or section. 

related tags 

• <MARK> 

• <REVISION> 

restrictions 

The <UPDATE_RANGE> tag has no effect on Bookreader output. 

Valid only in the context of a <REVISI0N> tag, and the <REVISI0N> tag must 
specify the ke5rword UPDATE. If you do not specify the <REVISI0N> tag, no 
output is generated from the <UPDATE_RANGE> and <ENDUPDATE_RANGE> 
tags. 

required 

terminator 

<ENDUPDATE_RANGE> 

DESCRIPTION 

The <UPDATE_RANGE> tag marks the location at which a new section of 
updated pages begins. Files coded with the <REVlSlON>(UPDATE\wj 3 c?ate 
info) tag and containing <UPDATE_RANGE> tags process as follows: 

• When the text formatter processes a file that has been marked as an 
update, it processes all text and commands in the file, but does not 
produce actual output for the DVI file, except for those pages marked 
within an update range. 
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<UPDATE RANGE> 


EXAMPLE 


• When the text formatter reaches the beginning of an update range, 
it sets the page number to the page number specified as the start 
of the update. Therefore, it is not important that previous versions 
of the text formatter file were modified for pagination during final 
production. All pages processed outside of an update range are not 
output. 

The following rules apply to the placement of the <UPDATE_RANGE> tag: 

• If the text on the first update page is in the middle of a text element 
(for example, a paragraph, a list element, a code example), then the 
<UPDATE_RANGE> tag must precede the word of text that is the first 
word on the page. 

• If the text on the first update page represents the beginning of a new 
text element (for example, the <P>, <LIST>, <LE>, <CODE_EXAMPLE> 
tags, and so on), you must place the <IJPDATE_RANGE> tag immediately 
preceding the tag for the text element. 

• If an update range begins on a page that starts with a continued 
table, the file must specify the start of the update range on the odd- 
numbered page preceding the beginning of that table, or (if the table 
begins on an odd-numbered page) the page on which the table begins. 
If these pages are not to be a part of the update, you can discard them. 

• If one or more pages before an update range begins contain a floating 
figure or example, you must modify the <FIGIJRE_ATTRIBUTES> or 
<EXAMPLE_ATTRIBUTES> tags to specify the KEEP argument. This 
prevents the text formatter from floating the figure or example to the 
top of the first update page. 

Put a <COMMENT> tag in the file to indicate that the modification was 
made for the purposes of the update only. For example: 

<COMMENT>(KEEP added to example for update only...) 

When the file is subsequently revised, you can remove the KEEP 
arguments. 

• When you process a file that contains the <REVISlON>(UPDATE) tag, 
the table of contents and index are handled as follows: if you specify 
/CONTENTS and /INDEX on the command line, you receive a table of 
contents and an index even if you do not specify the <C0NTENTS_FILE> 
and <INDEX_FILE> tags within the <UPDATE_RAlsrGE> and <ENDUPDATE_ 
RANGE> tags. 


In the following example, the updated material begins on page 5 and 
continues through page 24. When page 24 is reached, the page numbering 
becomes 24.1, 24.2, and so on, until the end of the update range is reached. 
You must place the <ENDUPDATE_RANGE> tag in the source file at the 
position corresponding to the place at which an update sequence ends. 
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<UPDATE RANGE> 


<REVISION>(UPDATEXNovember 1990) 


<UPDATE_RANGE>(5\2 4) 

<P> 

The first sentence on page 5 goes here. 


20 or more pages of modified text go here. 


The last sentence on page 24.n goes here. 
<ENDUPDATE RANGE> 
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<UPPERCASE> 

Labels text that you want to appear in uppercase in the final output. 

FORMAT 

<UPPERCASE>ftexy 

ARGUMENTS 

text 

Specifies the text you want to appear in uppercase. 

related tags 

• <LOWERCASE> 

DESCRIPTION 

The <UPPERCASE> tag labels text that you want to appear in uppercase 
in the final output. In your book, there may be a text element, such as a 
heading, that normally appears in lowercase. Use the <UPPERCASE> tag if 
you need to overcome the default case in one of your tags and ensure that 
the result in the final output appears in uppercase. 

EXAMPLE 

In the following example, assume that the doctype being used causes the 
<HEAD2> tag to output a heading that is in lowercase, no matter what the 
case of the text passed to it. The <UPPERCASE> tag overrides the default in 
tins <HEAD2> tag. 


<HEAD2>(Here is an example of <UPPERCASE>(uppercase) text.) 

This example produces the following output: 
Here is an example of UPPERCASE text. 
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<USER I MESSAGE> 



DESCRIPTION The <USER_I_MESSAGE> tag sends an informational message to the 

terminal, .LIS, or .LOG file during processing of a file. 

If you process the file interactively, the message will appear on your 
screen. If you process the file interactively and use the /LIST qualifier on 
the command line, the message is also listed in the .LIS file. 

If you process the file in batch and specify the /LOG qualifier on the 
command line, the message is listed in the .LOG file. 

You can use the tag to broadcast any important information that should be 
noted during processing; for example, you might use it as a reminder that 
you still must add information to a file. 

The tag translator displays the line number and the file name in which 
the tag appears. The message is output in the following format: 

%TAG-I-USER_IMSG, nuratmmmuimtrtminunnmu^^ 

Line is nnn of file fffffffffffff 

Note: If you want to generate only a few messages, you might choose 
to use the <USER_W_MESSAGE> tag and not process the file with the 
additional qualifier. 
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<USER I MESSAGE> 


EXAMPLE The following example shows how to use the <USER_I_MESSAGE> tag to flag 

a section of a file that requires further work. 

<USER_I_MESSAGE>(Section 2 is incomplete and requires 
information from Tom Smith.) 

Suppose the file containing this message is called “Chapter_l.SDML.” 
Depending on how you process this file, the message appears on your 
screen, in the .LIST file, or in the .LOG file as follows: 

%TAG-I-USER_IMSG, Section 2 is incomplete and requires information 
from Tom Smith. 

Line is 68 of file part2.sdml 




<USER W MESSAGE> 


<USER_W_ 

MESS AG E> 

Sends a warning message to the terminal, .LIS, or .LOG file during processing 
of a file. 

FORMAT 

<USER_W_MESSAGE>('i/i/arn/ngf text) 

ARGUMENTS 

warning text 

Specifies the text you want to appear on the terminal or in the .LIS or 
.LOG file. 

related tags 

• <USER_I_MESSAGE> 

restrictions 

For batch processing, you must process the file with the /LOG qualifier on 
the command line in order to see any <USER_W_MESSAGE> tag messages. 

The message text is limited to 150 characters. 

DESCRIPTION 

The <USER_W_MESSAGE> tag sends a warning message to the terminal, 
.LIS, or .LOG file during processing of a file. 

If you process the file interactively, the message will appear on your 
screen. If you process the file interactively and use the /LIST qualifier on 
the command line, the message is also listed in the .LIS file. 

If you process the file in batch and specify the /LOG qualifier on the 
command line, the message is listed in the .LOG file. 


Note: This type of message is counted by the tag translator as a warning 
message. After thirty warning messages, tag translation halts. 
Therefore, use the <USER_W_MESSAGE> tag for generating messages 
only if you are issuing a few messages. For a file that contains 
many messages, tag messages with <USER_I_MESSAGE> tags and 
process the file with the /LOG qualifier. 

You can use the tag to broadcast any important information that should be 
noted during processing; for example, you might use it as a reminder that 
a part of the file is incomplete. 

The tag translator displays the line number and the file name in which 
the tag appears. The message is output in the following format: 

%TAG-W-USER_WMSG, at tag <USER_W_MESSAGE> on line nnn of file 
ffffffff 

nmuriitmirrmrnmirinurmimininnu^ 
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<USER W MESSAGE> 


EXAMPLE The following example shows how to use the <USER_W_MESSAGE> tag to 

identify a notice in a file. 


<USER_W_MESSAGE>(Reviewers: Please note missing parameters here.) 

Suppose the file containing this message is called “Reviewers_copy.SDML.” 
Depending on how you process this file, the message appears on your 
screen, in the .LIST file, or in the .LOG file as follows: 

%TAG-W-USER_WMSG, at tag USER_W_MESSAGE on line nn of file 
Reviewers_copy.SDML. 

Reviewers: Please note missing parameters here. 
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<VALID_BREAK> 

Labels a permissible page break within a monospaceij example (created with 
the <CODE_EXAMPLE>, <DISPLAY>, <INTERACTIVE>, or <LINE_ART> tags). 

FORMAT 

<VALID_BREAK> 

ARGUMENTS 

None. 

related tags 

• <CODE_EXAMPLE> 

• <DISPLAY>— in the SOFTWARE doctype 

• <INTERACTIVE> 

• <LINE_ART> 

restrictions 

Valid only in the context of monospaced examples created with the <CODE_ 
EXAMPLE>, <DISPLAY> (in the SOFTWARE doctype), <INTERACTIVE>, or 
<LINE_ART> tags. 

DESCRIPTION 

The <VALID_BREAK:> tag labels a permissible page break within a 
monospaced example (created with the <CODE_EXAMPLE>, <DISPLAY>, 
<INTERACTIVE>, or <LINE_ART> tags). 

The text formatter attempts to keep an example together on a single page. 
If there is not enough room for an example on the current page, the text 
formatter chooses page breaks using blank lines in the example as valid 
places to break. If your example contains no blank lines, or if you want 
to specify better breaking points, you can use the <VALID_BREAK> tag to 
specify the places that are acceptable page breaks. 

This tag has no effect for Bookreader output. 

EXAMPLE 

<INTERACTIVE> 

<S>($) 

The following example shows how to use the <VALID_BREAK> tag. 


<U> (@SYS$SYSTEM:SHUTDOWN) 

<S>( SHUTDOWN — Perform an Orderly System Shutdown) 

<ELLIPSIS> 

<S>(CENTRAL, PRINTER, TAPES, DISKS, DEVICES, CARDS, NETWORK, OPERl) 
<S>(OPER3, OPER4, OPER5, OPER6, OPER7, OPER8, OPER9, OPERIO, OPERll,) 
<S>(OPER12) 

<VALID BREAK> 
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<VALID BREAK> 


<S>(%SHUTDOWN-I-DISLOGINS, Interactive logins will now be disabled.) 

<S>(%SET-I-INTSET, login interactive limit = 0 current interactive value = 17) 
<S>(%SHUTDOWN-I-SHUTNET, The DECnet network will now be shut down.) 

<S>(%SHUTDOWN-I-STOPQUEMAN, The queue manager will now be stopped.) 
<ENDINTERACTIVE> 



<VALID_TABLE_ROW_BREAK> 


<VALID_TABLE_ROW_BREAK> 

Marks a permissible place that a first-level table row, not a nested table row, 
may be broken across pages. 

FORMAT 

<VALID_TABLE_ROW_BREAK> 

ARGUMENTS 

None. 

related tags 

• <NESTED_TABLE_BREAK> 

restrictions 

Valid only in the context of a <TABLE> tag. 

Valid only in the last column of a 2- or 3-column, first-level table; you 
cannot specify this tag in a nested table. 

DESCRIPTION 

The <VALlD_TABLE_ROW_BREAK> tag marks a permissible place that a first- 
level table row, not a nested table row, may be broken across pages. If 
you do not use the <VALlD_TABLE_ROW_BREAK> tag inside a long table row, 
the text formatter tries to keep all the text on the same page of output 
and might issue an error message. In extreme cases, the text formatter 
could run out of memory tr 3 dng to process the table row and terminate 
processing. 

This tag has no effect for Bookreader output. 


EXAMPLE The following example shows how to use the <VALID_TABLE_ROW_BREAK> 

tag in a table with a long table row. 


<TABLE> 

<TABLE_ATTRIBUTES>(MULTIPAGE) 

<TABLE_SETUP>(2\9) 

<TABLE_ROW>(Item\Text that goes on for several paragraphs. 
<VALID_TABLE_ROW_BREAK> 

Text that is still inside the first table row. 

<P> 

<VALID_TABLE_ROW_BREAK> 

The last paragraphs for this table row.) 

<ENDTABLE> 
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<VARIABLE> 


<VARIABLE> 


Labels a program variable or number you want to typographically distinguish. 

FORMAT 

<VARIABLE>(v'ar/aib/e name) 

ARGUMENTS 

variable name 

Specifies the name of the variable to be typographically distinguished. 

related tags 

• <KEYWORD> 

DESCRIPTION 

The <VARIABLE> tag labels a program variable or number you want to 
typographically distinguish. Use this tag to format a variable consistently 
throughout a document and a document set. 

EXAMPLE 

The following example shows how to use the <VARIABLE> tag. 


<P>At this point in the processing, 
<VARIABLE>(VERSION_NUMBER) has the 
value of 2. 


This example produces the following output: 

At this point in the processing, VERSIONJSfUMBER has the value of 2. 
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<VBAR> 


<VBAR> 

Specifies a vertical bar anywhere in your file. You must use this tag, however, 
to specify a vertical bar in an argument to a tag. 


FORMAT <VBAR> 


ARGUMENTS None. 


rGlatod tags • The following tags label other characters that you must tag when they 

occur in an argument to a tag: 

<AMPERSAND> 

<BACKSLASH> 

<CPAREN> 

<OPAREN> 


restrictions 

Valid only in an argument to a tag. 

DESCRIPTION 

The <VBAR> tag specifies a vertical bar anywhere in your file. You must 
use this tag, however, to specify a vertical bar in an argument to a tag. 

If you use a literal vertical bar within an argument to a tag, the tag 
translator reads the vertical bar as beginning a section of text it should 
treat literally. This is because the tag translator uses a vertical bar ( 1 ) 
to begin a quoted string. The vertical bar may prevent the tag translator 
from correctly evaluating a tag, thus causing an error in your output. 

EXAMPLE 

The following example shows how to use the <VBAR> tag. 


<SUBHEAD1>(Labeling the Vertical Bar (<VBAR>) Within Your 
Code\label_vbar) 

<P>To pass a vertical bar (|) in an argument to a tag through 
to your output, . . . 


This example produces the following output: 

Labeling the Vertical Bar (|) Within Your Code 

To pass a vertical bar ( I ) in an argument to a tag through to your 
output, . . . 
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<x> 


<X> 


Creates a main index entry. For a printed book, the <x> tag creates a 
reference to the page on which this tag appears. For a book you create 
for Bookreader, the <x> tag creates a hotspot on the index entry that you 
click on to display the associated text. 


FORMAT <X> (index entry[ 1 attribute]) 


ARGUMENTS index entry 

Specifies the index entry you want to appear in the index. The 
capitalization you use is the capitalization that appears in the index. 

attribute 

This is an optional argument. It specifies the attributes that control 
the sorting and formatting of the index entry. Each attribute must be a 
separate argument. 


Attribute Function 

<XAPPEND>(string) Appends the specified string to the page reference in the 
index. 

You must leave a space between the left parenthesis of 
the <XAPPEND> tag’s argument and the word you want to 
append, in order to have a space in the output between the 
page number and the appended word. 

In page-range references, append the string to the 
<X>(...\ END) tag, not to the <X>(...\ BEGIN) tag. The 
<XAPPEND> tag has no effect for Bookreader output. 

BEGIN Begins a page-range reference. When you use this attribute, 

you must pair it with a following <X> tag that has identical 
text (including capitalization) and the END attribute. BEGIN 
and END have no effect for Bookreader output. 

BOLD Causes the page reference number to appear in boldface. 

This is distinct from any boldfacing that appears in the text of 
the index entry itself. Use the <EMPHASIS> tag if you want 
to bold the index entry. BOLD has no effect for Bookreader 
output. 

BOTH Specifies an index entry that you want to appear in both a 

single-document and a master index. BOTH has no effect for 
Bookreader output. 

END Ends a page-range reference. When you use this attribute, 

you must pair it with a previous <X> tag that has identical 
text (including capitalization) and the BEGIN attribute. BEGIN 
and END have no effect for Bookreader output. 
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<x> 


related tags 


restrictions 


DESCRIPTION 


Attribute 

Function 

ITALIC 

Causes page reference numbers to appear in italics in your 
index entry. If you specify both BOLD and ITALIC, the entry 
is output in bold italics. Use the <EMPHASIS> tag if you want 
to bold the index entry. ITALIC has no effect for Bookreader 
output. 

MASTER 

Specifies that an index entry appear only in a master index. 

A master index is an index generated by specifying /MASTER 
on the DOCUMENT command line. By default, the entries 
appear only in a single-document index. Using /MASTER 
allows you to specify different entries for a single book’s index 
and for the master index of the document set. MASTER has 
no effect for Bookreader output. 

NOMASTER 

Specifies that an index entry appear only in a single¬ 
document index and not in a master index. NOMASTER 
has no effect for Bookreader output. 

<XSORT>(string) 

Uses the specified string as the sort key when placing this 
entry in the index, forcing the entry to sort in a place different 
from where it would by default. 


• <xs> 

• <XSUBENTRY> 

• <Y> 


Invalid in informal code examples. Using this tag in a code example 
interferes with the formatting of the example. 

In tables, place <X> tags directly next to the items you want to index 
(within the arguments to the <TABLE_ROW> tag, so that the page references 
will be correct if the table breaks across pages), or after the <TABLE_HEADS> 
or <TABLE_SETUP> tags. 

In tables you create for Bookreader, place <X> tags after <TABLE_HEADS>, 
<TABLE_ROW>, or <TABLE_SETUP> tags SO that the index entry points to the 
table pop-up window. 

If you want an index entry to point to a small section of text, you must 
place the index tag within the section of text, so that the index entry 
refers to the correct page. 

If you want an index entry to point to a large section of text denoted by a 
heading, you must place the index tag after the relevant <HEADn> tag, not 
before it, so that the index entry refers to the correct page. 


The <X> tag creates a main index entry in either a single-document or 
a master index. A master index is an index generated by specifying 
the /MASTERJNDEX qualifier on the DOCUMENT command line; a 
single-document index is an index generated by specifying /INDEX on the 
command line. 
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For a printed book, the <x> tag creates a reference to the page on which 
this tag appears. For a book you create for Bookreader, the <X> tag creates 
a hotspot on the index entry that you click on to display the associated 
text. The entry is composed of the main entry and optional subentries, 
which you specify in the first argument to the tag using the <XSUBENTRY> 
tag. See the <XSUBENTRY> tag description for more information. 

Code your index entries within the information you want the entry to point 
to, which ensures that the index will point to the correct page or section of 
information. 

You can control how the index entry is sorted and how it appears by 
specifying particular kejrwords as attribute arguments. 

For example, the <XAPPEND> attribute is useful when appending text to the 
end of a page reference, as when referring to an example (5-4ex) or to a 
table (9-8tab). You can also use the <XAPPEND> attribute to append “ff’ or 
“passim”, for example, to the page number. The <XAPPEND> attribute has 
no effect for Bookreader output. 

The appended string is boldfaced or italicized if its page reference is 
boldfaced or italicized. You can use the BOLD and ITALIC attributes 
together. BOLD and ITALIC have no effect for Bookreader output. 

You can create an index entry for several inclusive pages by using the 
BEGIN and END attribute. When using a BEGIN and END pair, you 
must be certain that the index entries are identical and that any other 
attributes you specify are the same for each entry, as well. The BEGIN 
and END pair have no effect for Bookreader output. 

If you have an index entry for which you want to control the sorting, use 
the <XSORT> attribute. For example, you can sort the word “Cat” under 
the “-D-” entries. If you want to control the sorting of nonalphabetic 
characters, use the /INDEX=SORT= qualifier on the DOCUMENT 
command line. See Appendix A for more information on the command 
line. 

You can specify that an index entry appear in a master index by using the 
MASTER attribute. No entry marked with the MASTER attribute appears 
in the single-document index. 

You can specify an index entry that you do not want to appear in a master 
index by using the NOMASTER attribute. This attribute limits the entry 
to appear only in a single-document index. 

You can specify an index entry that you want to appear in both a single¬ 
document and a master index by using the BOTH attribute. 

If you do not specify an attribute, the entry appears only in the single¬ 
document index unless you override this default with the following 
DOCUMENT command line qualifiers: 

\INDEX=OVERRIDE_MASTER Creates a single-document index 

containing both master and single¬ 
document index entries. 
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\MASTER_INDEX=OVERRIDE_MASTER Creates a master index containing 

both master and single-document 
index entries. 

An index entry that you label with the NOMASTER attribute is included 
only in the single-document index regardless of which “OVERRIDE” 
qualifier you use on the command line. 

An index entry that you label with the BOTH attribute is included in 
both the single-document and the master index regardless of which 
“OVERRIDE” qualifier you use on the command line. 

Table 1-5 summarizes how the <X> tag attributes and the command line 
indexing options for a single-document and a master index interact. An 
“X” specifies that an index entry with the listed tag attribute runs with 
the command line option to produce an index. 


Table 1-5 Interaction of <X> Tag Arguments and Command Line indexing Options 


<X> Tag 
Attributes 


Command Line Options 


For a Single-document Index 

For a Master index 

/INDEX 

/INDEX=:OVERRIDE 

/MASTER 

/MASTER=OVERRIDE 

none 

X 

X 


X 

BOTH 

X 

X 

X 

X 

MASTER 


X 

X 

X 

NOMASTER 

X 

X 




For example, if you want to specify that certain index entries appear in a 
master index but not in a single-document index, code the entries using 
the MASTER attribute. 

If you want to generate a single-document index that includes 
index entries that you coded with the MASTER attribute, use the 
/INDEX=OVERRIDE qualifier on the command line. 

If you want to generate a master index that includes index entries that 
you coded without the MASTER attribute, use the /MASTER=OVERRIDE 
qualifier on the command line. 

If you want to generate a master index that includes some of your coded 
index entries (both with and without using the MASTER attribute) while 
excluding other entries, do the following: 

1 Edit your .SDML file by adding the NOMASTER attribute to the 
entries you want excluded. 

2 Process your book using the /MASTER=OVERRIDE qualifier on the 
command line. 
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If you want to generate a single-document index that includes some but 
not all of the entries you coded using the MASTER attribute, without 
having to remove the MASTER attribute from the entries you want to 
include, do the following; 

1 Edit your .SDML file by changing the MASTER attribute to BOTH for 
those entries you want to include. 

2 Process your book to generate a single-document index by using the 
/INDEX qualifier on the command line. 

Consider the following when indexing for Bookreader output: 

• Be sure to place your index entries within the information you want 
the entry to point to, which ensures that the entry in the index will 
point to the correct topic of information. 

• You can place index tags anywhere in your table, except directly after 
the <TABLE> tag, or else the entries will point to the previous text 
instead of to the table in the pop-up window. 

• In formal examples and formal figures, place the index tags before 
the <ENDEXAMPLE> or <ENDFIGUEE> tag, SO that clicking on the entry 
in the index causes the actual example or figure to pop up. Do not 
place index entries within a code example, or the code example may 
not be formatted correctly. 

Refer to Appendix A for more information on using the /INDEX qualifier 
on the DOCUMENT command line. 


EXAMPLES The following example shows how to position the <X> tag to provide an 

index entry for a chapter. 

Q <GHAPTER>(Creating Routines\creating_routine_sec) 

<X>(Routines<XSUBENTRY>creation of) 

<P> 

In order to create a routine, you must first ... 

If the previous text appeared on page 11-2, the <X> tag would create the 
following output under the heading “R”; 

Routines 

creation of, 11-2 

The following example shows how to create an inclusive index entry using 
the BEGIN and END attributes. 

§ <X>(File structure\begin) 


<X>(File structure\end) 

This example produces the following output under the heading “F”: 

File structure, 5-4 to 5-7 
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The following example shows how to use the <XAPPEND> attribute. Notice 
that you must leave a space between the left parenthesis of the <XAPPEND> 
attribute’s argument and the word you want to append, in order to have a 
space in the output between the page number and the appended word. 

§ <X>(File structure\begin) 

<X>(File structure\end\<XAPPEND>( passim)) 

This example produces the following output under the heading “F”: 

File structure, 5-4 to 5-7 passim 

The following example shows how to code multiple subentries for a 
particular main entry. 

2 <X>(Debugger<XS>features of) 


<X>(Debugger<XS>exiting from) 


<X>(Debugger<XS>invoking) 

This example produces the following output under the heading “D”: 

Debugger 

exiting from, 2-4 
features of, 1-7 
invoking, 3-9 

The following example shows where to put an index tag in a table, and 
creates an index entry that correctly specifies the page that the text 
“bananas” appears on, no matter where VAX DOCUMENT breaks the 
table. 


1^ <TABLE_ROW>(apples\oranges\pears) 

<TABLE_ROW>(<X>(Tropical fruits<XS>bananas)bananas\pineapples\mangos) 

<TABLE_ROW>(blackberries\blueberries\strawberries) 

This example produces the following output under the heading “T”: 

Tropical fruits 
bananas, 3-21 

The following example shows how to use the <XSORT> attribute. “Tsar” is 
placed with the “C” entries after “Czar” rather than with the “T” entries. 

0 <X>(Tsar<XSUBENTRY>country of\<XSORT>(Czar)) 

This example produces the following output: 

Cat, 3-6 
Czar, 1-16 
Tsar 

country of, 3-21 
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The following example shows how to code an index entry that you want to 
appear only in a master index, 

Q <X>(Classical music\MASTER) 


The following example shows how to code an index entry that you want to 
appear only in an individual index and not in a master index. 

^ <X>(Jaz 2 music\NOMASTER) 


The following example shows how to code an index entry that you want to 
appear in both an individual and a master index. 

^ <X>(Alternative rock music\BOTH) 
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<xs> 

Separates the main index entry from the first subentry, the first subentry from 
the second, and the second subentry from the third. Used within the argument 
to the <x> or <Y> tags. For a printed book, the <xs> tag creates a reference 
to the page on which the tag appears. For a book you create for Bookreader, 
the <xs> tag creates a hotspot on the index entry with no page reference. 
(The <xs> tag is identical to the <xsubentry> tag.) 

FORMAT 

<XS> (subentry-1 [<xs>subentry-2[<xs>subentry-3]]) 

ARGUMENTS 

subentry 

Specifies up to three subentries you want to appear in the index. The 
capitalization you use is the capitalization that appears in the index. 

related tags 

• <x> 

• <XSUBENTRY> 

• <Y> 

restrictions 

Valid only within the argument to an <X> or <Y> tag. 

You can use a maximum of three subentries in the index. 


DESCRIPTION 


The <XS> tag separates the main index entry from the first subentry, the 
first subentry from the second, and the second subentry from the third. 
For example: 


<x>(main entry<xs>subentiy-1 <xs>subentry-2<xs>subentry-3) 

For a printed book, the <XS> tag creates a reference to the page on which 
the tag appears. For a book you create for the Bookreader, the <XS> tag 
creates a hotspot on the index entry with no page reference. 

An index entry for a book you create for Bookreader that contains more 
than one reference to another section displays all the index selections in a 
separate pop-up window. See VAX DOCUMENT Producing Online and 
Printed Documentation for a graphic example. 
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EXAMPLES The following example shows how to use the <XS> tag. 

Q <X>(Vehicles<XS>use of) 

If the previous index tags appeared on page 3-1, they would create the 
following index entry under the heading “V”: 

Vehicles 

use of, 3-1 

The following example shows how to use the <XS> tag to create a “See also” 
entry. 


§ <X>(File structure designators) 

<Y>(File structure designators<XS>See also Header blocks) 

If the previous tags appeared on page 1-3, they would create the following 
index entry under the heading “F”: 

File stucture designators, 1-3 
See also Header blocks 

The following example shows how to code multiple subentries for a 
particular main entry. 

g <X>(Debugger<XS>features of) 


<X>(Debugger<XS>exiting from) 


<X>(Debugger<XS>invoking) 

The previous tags produce the following entries under the heading “D”: 

Debugger 

exiting from, 1-7 
features of, 2-4 
invoking, 3-9 

The following example creates unnumbered index entries (because of the 
<Y> tag, which you use for unnumbered “See” and “See also” entries). 

0 <Y>(CORP-AUTO report<XS>See Reports<XS>See also Cars) 

Regardless of what page the previous tags appear on, they produce the 
following output imder the heading “C”: 

CORP-AUTO report 
See Reports 
See also Cars 
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<XSUBENTRY> 

Separates the main index entry from the first subentry, the first subentry 
from the second, and the second subentry from the third. Used within the 
argument to the <x> or <y> tags. For a printed book, the <xsubentry> tag 
creates a reference to the page on which the tag appears. For a book you 
create for Bookreader, the <xsubentry> tag creates a hotspot on the index 
entry with no page reference. The <xsubentry> tag is identical to the <xs> 
tag. 

FORMAT 

<XS\JBEfiTRY>(subentry-1[<xs[jBEmRY>subentry-2 

[<xs[jBEmRY>subentry-3]]) 

ARGUMENTS 

subentry 

Specifies up to three subentries you want to appear in the index. The 
capitalization you use is the capitalization that appears in the index. 

related tags 

• <x> 

• <xs> 

• <Y> 

restrictions 

Valid only within the argument to an <x> or <Y> tag. 

You can use a maximum of three subentries in the index. 

DESCRIPTION 

The <XSUBENTRY> tag separates the main index entry from the first 
subentry, the first subentry from the second, and the second subentry 
from the third. For example: 

<x>(main entry<xsuBENTRY>subentry-1<xsuBENTRY>subentry-2<xsuBENTRY>subentry-3) 

For a printed book, the <XSUBENTRY> tag creates a reference to the page 
on which the tag appears. For a book you create for Bookreader, the 
<XSUBENTRY> tag creates a hotspot on the index entry with no page 
reference. 

An index entry for a book you create for Bookreader that contains more 
than one reference to another section displays all the index selections in a 
separate pop-up window. See VAX DOCUMENT Producing Online and 
Printed Documentation for a graphic example. 
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EXAMPLES The following example shows how to use the <XSUBENTRY> tag. 

Q <X>(Vehicles<XSUBENTRY>use of) 

If the previous index tags appeared on page 3-1, they would create the 
following index entry under the heading “V”: 

Vehicles 

use of, 3-1 

The following example shows how to use the <XS> tag to create a “See also” 
entry. 


§ <X>(File structure designators) 

<Y>(File structure designators<XSUBENTRY>See also Header blocks) 

If the previous tags appeared on page 1-3, they would create the following 
index entry under the heading “F”: 

File stucture designators, 1-3 
See also Header blocks 

The following example shows how to code multiple subentries for a 
particular main entry. 

^ <X>(Debugger<XSUBENTRY>features of) 


<X>(Debugger<XSUBENTRY>exiting from) 


<X>(Debugger<XSUBENTRY>invoking) 

The previous tags produce the following entries under the heading “D”: 

Debugger 

exiting from, 1-7 
features of, 2-4 
invoking, 3-9 

The following example creates unnumbered index entries (because of the 
<Y> tag, which you use for unnumbered “See” and “See also” entries). 

gj <Y>(CORP-AUTO report<XSUBENTRY>See Reports<XSUBENTRY>See also Cars) 

Regardless of what page the previous tags appear on, they produce the 
following output under the heading “C”: 

CORP-AUTO report 
See Reports 
See also Cars 


1-297 




<Y> 


<Y> 


Used with the <xsubentry> tag to create a main index entry and a subentry 
that has no page reference for a printed book and no hotspot for a book 
you create for Bookreader. Use the <Y> and <xsubentry> tags for cross- 
references (“See” or “See also” entries) to other index entries. 


FORMAT < Y> (index entry[ 1 attribute]) 


ARGUMENTS index entry 

Specifies the main entry and subentries that appear in the index. The 
capitalization you use is the capitalization that appears in the index. 

attribute 

This is an optional argument. It specifies the attributes that control the 
sorting of the index entry. You can specify a maximum of two attribute 
arguments. Each attribute must be a separate argument. The possible 
attributes follow: 


related tags 


restrictions 


Attribute 

Function 

BOTH 

Specifies an index entry that you want to appear in both a 
single-document and a master index. BOTH has no effect for 
Bookreader output. 

MASTER 

Specifies that an index entry appear only in a master index. A 
master index is an index generated by specifying /MASTER on 
the DOCUMENT command line. By default, the entries appear 
only in a single-document index. Using /MASTER allows you 
to specify different entries for a single book’s index and for the 
master index of the document set. MASTER has no effect for 
Bookreader output. 

NOMASTER 

Specifies that an index entry appear only in a single-document 
index and not in a master index. NOMASTER has no effect for 
Bookreader output. 

<XSORT>(string) 

Uses the specified string as the sort key when placing this 
entry in the index, forcing the entry to sort in a place different 
from where it would by default. 


• <x> 


• <xs> 


• <XSUBENTRY> 



Invalid in informal code examples. Using this tag in a code example 
interferes with the formatting of the example. 
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DESCRIPTION Use the <Y> tag with the <XSUBENTRY> tag to create a main index 

entry and a subentry that has no page reference for a printed book 
and no hotspot for a book you create for Bookreader. Use the <Y> and 
<XSUBENTRY> tags for cross-references (“See” or “See also” entries) to other 
index entries. You specify the subentries by using the <XSUBENTRY> tag 
within the argument to the <Y> tag. See the <XSUBENTRY> tag description 
for more information. 

The <Y> tag subentries sort alphabetically at the top of the subentry list, 
before the <X> tag subentries; that is, cross-references to a topic are listed 
before its subtopics. 

For information on how to use the MASTER, NOMASTER, BOTH, and 
<XSORT> attributes, see the <X> tag description. 


EXAMPLES The following example shows how to use the <Y> tag. 

Q <X>(File structure designators) 

<Y>(File structure designators<XSUBENTRY>See also Header blocks) 

If the previous index tags appeared on page 1-3, they would create the 
following index entry under the heading “F”: 

File stucture designators, 1-3 
See also Header blocks 

The following example shows how to use the <Y> tag to create an 
unnumbered index entry. 


§ <Y>(File structure designators<XSUBENTRY>See also Header blocks) 

The previous tags create the following output under the “F” entry: 

File stucture designators 
See also Header blocks 

The following example shows how to code multiple “See also” references 
for a particular main entry. 

§ <Y>(Debugger<XS>See also Debugger commands; Debugging; /DEBUG 

qualifier) 

The previous tags produce the following output under the heading “D”: 

Debugger 

See also Debugger commands; Debugging; /DEBUG qualifier 

The following example shows how to use the <Y> tag to sort the entry 
“Cat”. 

0 <Y>(Cat<XSUBENTRY>See also Feline\<XSORT>(Animals)) 

The previous tags produce the following output, where “Cat” is placed with 
the “A” entries after “Animals” rather them with the “C” entries: 

Cat 

See also Feline 
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A VAX DOCUMENT Command Summary 


This appendix lists and describes all the VAX DOCUMENT commands. 
The appendix is separated into two command summarys: 

• DOCUMENT[/FORMATTER] 

Starts the VAX DOCUMENT formatting system. 

You can find a summary of this information by typing the following 
command at the DCL prompt: 

$ HELP DOCUMENT[/FORMATTER] 

• DOCUMENT/GENERATE_SYMBOL 

Starts the VAX DOCUMENT symbol generator. 

You can find a summary of this information by typing the following 
command at the DCL prompt; 

$ HELP DOCUMENT/GENERATE_SYMBOL 

The HELP file also provides a summary of commands for using the 
Graphics Editor. You can type the following command at the DCL prompt: 

$ HELP DOCUMENT/GRAPHICS 

See the VAX DOCUMENT Graphics Editor User^s Guide for more 
information about the Graphics Editor. 



DOCUMENT[/FORMATTER] 


DOCUMENT[/FORMATTER] 

Starts the VAX DOCUMENT formatting system. 

FORMAT 

DOCUMENT[/FORMATTER] input-file doctype 


destination 


Command Qualifier 

Default 


/[NO]BATCH[=qualifier-keyword] 

/NOBATCH 


/CONDITION=condition-name 

None. 


/[NOJCONTENTS 

/NOCONTENTS 



/CONTENTS (Bookreader) 


/[NOJDEVICE CONVERTER[=device-keyword] 

/DEVICE CONVERTER 


/[NOJDIAGNOSTICSHile-spec] 

/NODIAGNOSTICS 


/ELEMENT=fHe-spec 

None. 


/INCLUDE=file-spec 

None. 


/[NO]INDEX[=index-keyword] 

/NOINDEX 


/[NO]KEEP[=filetype-keyword] 

/NOKEEP 


/[NO]LIST[=file-spec] 

/NOLIST 


/[NOJLOG 

/LOG 


/[NO]MAP[=file-spec] 

/NOMAP 


/[NOJMASTER lNDEX[=index-keyword] 

/NOMASTERJNDEX 


/OUTPUT=file-spec 

See text. 


/[NO]PRINT[=qualifier-keyword] 

/NOPRINT 


/PROFILE=file-spec 

None. 


/[NOJSYMBOLS=file-spec 

/NOSYMBOLS 


/[NOJTAG TRANSLATOR 

/TAG TRANSLATOR 


/[NOJTEXT FORMATTER 

/TEXT FORMATTER 

restrictions 

The /FORMATTER command is the default. It is positional; if you use it. 


it must immediately follow DOCUMENT. 



PARAMETERS input-file 

Specifies the input file to be processed. You cannot use wildcards in the 
input file specification. 


The default file type of the input file is SDML. If you specify qualifiers, 
VAX DOCUMENT determines the default file type based on the qualifiers 
and the destination keyword you specify. Table A—1 lists the qualifiers, the 
default destinations, and the default file types. 
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Table A-1 Default File Types 


VAX DOCUMENT 

Qualifiers Used 

Default Destination 
Keyword Used 

Default input 
File Type 

None. 

Any 

SDML 

/TAG_TRANSLATOR 

Any 

SDML 

f /NOTAG TRANSLATOR V 

1 /TEXT_FORMATTER J 

Any 

TEX 

f /NOTAG TRANSLATOR ) 

BOOKREADER 

DVI LN03 

^ /NOTEXT FORMATTER \ 

LN03 

DVI PS 

( /DEVICE_CONVERTER J 

PS 

DVI LINE 


LINE 

DVI LINE 


MAIL 

TERMINAL 

dvlline 

f /NOTAG TRANSLATOR 1 

LN03 

DVI 

1 /NOTEXT FORMATTER 1 

1 PS 

BOOKREADER 

] /NODEVICE CONVERTER I 

LINE 

LN03 

( /PRINT J 

MAIL 

PS 


TERMINAL 

LINE 


TXT 

TERM 


^ Braces in this table indicate that the enclosed qualifiers occur together on the 
command line. 


doctype 

The doctype you indicate on the command line determines both the style 
of your output and the SDML tags you can use. Note that some tags are 
valid only in specific doctypes. 

A number of doctypes have a choice of designs. A design is a specialized 
form of a doctype. You specify the design keyword immediately after 
the doctype ke 5 rword and separate them with a period (.); for example, 
SOFTWAKE.REFERENCE. You can abbreviate the doctype keyword; for 
example, you could shorten SOFTWARE.REFERENCE to S.R, as long as 
each keyword is imique. 

See VAX DOCUMENT Using Doctypes and Related Tags for more 
information on doctypes and doctype-specific tags. 

destination 

Specifies the output device destination for the document. VAX 
DOCUMENT supports the following output destinations; your local 
destinations may be different. 


Destination Keyword Formatted For 


Output File Type 


BOOKREADER Bookreader output 

HELP Building a Help file 

LINE A line printer 

LN03 An LN03 laser printer 


.DECW$BOOK 

.HLP 

.LINE 

.LN03 
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Destination Keyword 

Formatted For 

Output File Type 

PS 

Any Digital-supported PostScript output 
device, such as the PrintServer 40 or the 
LN03R ScriptPrinter 

.PS 

MAIL 

Sending through the VMS Mail Utility 

.TXT 

TERMINAL 

A standard ANSI terminal, such as the 
VT-100 

.TERM 


You can abbreviate the destination keyword. For example, you could 
abbreviate LN03 to LNO, or even LN, as long as that destination is unique. 

Note that monospaced fonts defined for all the sizes are provided for text 
fonts in the POSTSCRIPT destination. 

You can have additional local destination keywords defined at your site. 
See your VAX DOCUMENT system administrator for information on local 
destination keywords. 


DESCRIPTION DOCUMENT is the command you specify to start VAX DOCUMENT. It 

requires three parameters: 

• Input File 

Specifies the input file for VAX DOCUMENT. By default, this file is an 
SDML file containing SDML tags; however, it can also be one of the 
intermediate files generated by VAX DOCUMENT. 

• Doctype 

Specifies the document type for which the input file will be processed. 
This ke 3 rword specifies the kind of document you want to create (a 
letter, a software manual, a journal article, and so on). 

• Destination 

Specifies the final processing destination for the input file. This 
keyword specifies a format used by a printer, Bookreader, a terminal, 
or the VMS Mail Utihty. 

You can use qualifiers to the DOCUMENT command to create an index, 
master index, and table of contents, and to modify the default processing 
of your input file. 


QUALIFIERS /BATCH[=(qualifier keyword[,qualifier keyword...])] 

/NOBATCH 

Specifies whether VAX DOCUMENT should be run interactively or run as 
a batch job. The default qualifier is /NOBATCH, which specifies that VAX 
DOCUMENT be run interactively. 

The /BATCH qualifier submits a job to SYS$BATCH with a job name that 
has the same file name as the input-file, prefixed with the string “DOC$.” 
For example, the file ROUTINES.SDML would be submitted as the job 
DOC$ROUTINES. 
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You can use any of the DCL SUBMIT command qualifiers with VAX 
DOCUMENT by using these qualifiers as keywords to the /BATCH 
qualifier. For example, if you want DOCUMENT to be run after 9:00 
and want to be notified when it completes, you could use the following 
command: 

$ DOCUMENT file-spec /BATCH=(AFTER=09:00,NOTIFY) LETTER LN03 

When you use the /BATCH qualifier, a file is created in your current 
default directory that contains information about the batch job. This file 
has the same file name as the input file, with a default file type of LOG. 
When your batch job completes, this file is printed to the queue defined by 
the logical SYS$PRINT, and the file is deleted. 

You must define any process logical names you enter on the DOCUMENT 
command line in your LOGIN,COM file. Otherwise, VAX DOCUMENT is 
unable to translate the logical name during batch processing and issues an 
error message. 

/CONDlTION=:condition name 

Specifies a condition keyword for an SDML input file. This qualifier 
accepts a condition name argument that is a text string used to mark 
the condition being set. For more information on using the /CONDITION 
qualifier, see the <SET_C0NDITI0N> tag description and VAX DOCUMENT 
Producing Online and Printed Documentation. 

The /CONDITION qualifier is valid only if tag translation is being done. 

If you specify /NOTAG.TRANSLATOR with the /CONDITION qualifier, 
the /CONDITION qualifier is ignored, and VAX DOCUMENT issues an 
informational message stating that you specified conflicting qualifiers. 

/CONTENTS 

/NOCONTENTS 

Specifies whether a table of contents file is produced. The /NOCONTENTS 
qualifier is the default (except when processing for Bookreader, 
where /CONTENTS is the default) and specifies that no table of 
contents is produced. When you specify the /CONTENTS qualifier, 

VAX DOCUMENT creates a table of contents file with a file name of 
input_Jilename_CONTENTS. 

If you place the <C0NTENTS_FILE> tag in your front matter or profile SDML 
file, the current table of contents file is included at the corresponding point 
in the final printable output file (filename.LNOS, filename.PS, and so on). 
If you do not place the <CONTENTS_FILE> tag in your SDML file, the table 
of contents is not incorporated into your final output file, but is placed in 
the separate file, input _/i/ename_CONTENTS, and processed separately. 

For Bookreader output, a table of contents is generated automatically even 
if you do not specify the /CONTENTS qualifier on the command line or use 
the <C0NTENTS_FILE> tag in your SDML file. 

If you do not specify /CONTENTS on the DOCUMENT command line 
when you process a file that contains a <CONTENTS_FILE> tag, VAX 
DOCUMENT issues warning messages and the most recent version of 
the table of contents file is included. Note that this may result in an 
outdated table of contents being included in your document. If there is 
no previous table of contents file to be included, you receive a warning 
message and a blank page of output. 
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The /CONTENTS qualifier is valid only if text formatting is being done. 

If you specify /NOTEXT_FORMATTER with the /CONTENTS qualifier, 
VAX DOCUMENT issues a warning message stating that you specified an 
illegal combination of command elements. 

Note that if you process your document with the /NOTAG_TRANSLATOR 
and /CONTENTS qualifiers, and the table of contents is included using 
the <C0NTENTS_FILE> tag, the table of contents is incorporated into 
your document, placed in the file filenamejCONTENTS, and processed 
separately. 

Note: The maximum length of a VMS file name is 39 characters. If you 
want to generate a contents file^ your input file name must have 
no more than 30 characters, because appending _CONTENTS to it 
adds 9 more characters. 

For more information on generating a table of contents, see VAX 
DOCUMENT Producing Online and Printed Documentation and the 
<CONTENTS_FILE> tag description. 

/DEVICE_CONVERTER[=(devlce keyword [.device 
keyword...])] 

/NODEVICE_CONVERTER 

Specifies whether the device converter is run. Using /NODEVICE_ 
CONVERTER excludes device conversion. 

The device converter reads and processes an intermediate file (with the 
file type .DVLjdevice) and converts it to a file suitable for output on the 
destination device. The output from the device converter has the same file 
name as the input file you specified on the command line, and a file type 
based on the destination ke 5 rword you specified on the command line. 

The /DEVICE_CONVERTER qualifier optionally accepts the following 
ke 3 rwords for special processing of your file: 


Device Keyword Description 

BLANK_PAGES Specifies that the PostScript device converter insert blank pages 

where needed in the PostScript output to create a two-sided 
document for printing on a duplex printer or for copying on a 
two-sided copier. 

HORIZONTAL_OFFSET=r7u/77ber o/po/nfs Specifies where the text is to be positioned, relative to the left edge 

of the paper. The default horizontal offset for the page is one inch 
(72 points). 

The number of points argument specifies the number of points the 
text page should be moved to the right from the left edge of the 
paper. This argument must be zero or a positive integer. The left 
edge of the paper is assumed to be zero. 
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Device Keyword 

Description 

VERTlCAL_OFFSET=nL/mber of points 

Specifies where the text is to be positioned, relative to the top edge 
of the paper. The default vertical offset for the page is one inch (72 
points). 

The number of points argument specifies the number of points 
the text page should be moved toward the page bottom from the 
top edge of the page. This argument must be zero or a positive 
integer. The top edge of the paper is assumed to be zero. 

STARTING_PAGE=/b//b spec 

Specifies the beginning page number of the first page in a range of 
pages to be printed. If you do not specify an ending page, the rest 
of the file is printed. The foiio spec value can be any valid page 
number that VAX DOCUMENT produces on the page. 

ENDING_PAGE=/b//b spec 

Specifies the ending page number of the last page in a range of 
pages to be printed. The folio spec value can be any valid page 
number that VAX DOCUMENT produces on the page. If both the 
ENDING_PAGE and NUMBER_OF_PAGES keywords are used 
together on the same command line, VAX DOCUMENT issues an 
error message. 

NUMBER_OF_PAGES=max/y77um pages 

Specifies the number of pages to print when you do not specify 
the ENDING_PAGE keyword. If both the ENDING_PAGE and 
NUMBER_OF_PAGES keywords are used together on the same 
command line, VAX DOCUMENT issues an error message. 

The maximum pages value must be an integer specifying the total 
number of pages to print. If this number is specified as a number 
larger than the number of pages in the document (for example, 
99999), all pages of the document are printed. 


Use the STAKTING_PAGE and ENDING_PAGE keywords to specify the 
page numbers that are to be processed. Each of these keywords accepts a 
folio spec argument. A folio spec has the following syntax: 

[{folio prefix}{separator}] (page number} 

The following list describes the rules for each of the folio spec syntax 
elements: 

• folio prefix 

Specifies the numbers or letters that prefix the folio spec. A folio prefix 

can be any of the following: 

— Any single letter. Specifies an appendix in your document, for 
example, the letter “B” in the folio spec B-6. 

— Any number. Specifies a chapter number, for example, the number 
“13” in the folio spec 13-1. 

— The keywords GLOSSAKY or INDEX. Specifies a page in the 
glossary or index, for example, “INDEX” in the folio spec INDEX-6. 

— The ke 3 rword PART/z where n is an integer of one or greater. 
Specifies a section begun using a <PART_PAGE> tag, for example, 
“PART2” in the folio spec PAIIT2—7. 

— An asterisk (*). Specifies the first section of your document. 
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• separator 

Specifies the character that separates the folio prefix from the page 
number. The separator can be any single character that is not a space, 
a number, or a letter. In the folio spec 11-3, is the folio prefix. You 
cannot use a separator if you do not specify a folio prefix. 

• page number 

Specifies the page number portion of a folio spec. In the folio spec 
11-3, “3” is the page number. The page number can be a Roman 
number, an Arabic number, or an asterisk (*). Roman numbers 
specify a page in the preface of a document, Arabic numbers specify 
pages outside the preface section, and the asterisk (*) specifies the 
first page of the document section specified by the folio prefix. 

The following DOCUMENT command specifies that pages 11-3 through 
11-8 of file MYREPORT.DVI_LN03 be processed by the device converter. 

$ DOCUMENT/NOTAG_TRANSLATOR/NOTEXT_FORMATTER myreport.DVI_LN03 - 
_$ REPORT LN03/DEVICE=(STARTING=ll-3,ENDING=ll-8) 

/DIAGNOSTICS[=file spec] 

/NODIAGNOSTICS 

Causes the tag translator to write VAX Language-Sensitive Editor (LSE) 
diagnostics records to a file. LSE uses these records during its REVIEW 
phase to locate and describe translation errors. The default qualifier is 
/NODIAGNOSTICS. See VAX DOCUMENT Producing Online and Printed 
Documentation for more information on LSE. 

If you omit the file specification, the output file has the same name as the 
input file, with a file type of DIA. 

The /DIAGNOSTICS qualifier is valid only if tag translation is being done. 
If you specify /NOTAG_TRANSLATOR with the /DIAGNOSTICS qualifier, 
VAX DOCUMENT issues a warning message stating that you specified an 
illegal combination of command elements. 

/ELEMENT=file spec 

Names the book element that includes the input file specified on the 
command line. When you use the /ELEMENT qualifier to process a 
subelernent of a book, you must also use the /PROFILE qualifier to specify 
the profile for the book that contains the book element. If you do not 
specify the file type of the element file, the default file type is SDML. 

For more information on processing a subelement of a book, see VAX 
DOCUMENT Producing Online and Printed Documentation. 

The /ELEMENT qualifier is valid only if tag translation is being done. 

If you specify /NOTAG_TRANSLATOR with the /ELEMENT qualifier, 

VAX DOCUMENT issues a warning message stating that you specified an 
illegal combination of command elements. 

/mCLUDE=file spec 

Specifies a VAX DOCUMENT file that you want to be included before the 
input file you specified on the command line. If you do not specify the 
file type of the file to be included, SDML is the default file type. You can 
use the /INCLUDE qualifier on the command line only once. For more 
information about using the \ INCLUDE qualifier, see VAX DOCUMENT 
Producing Online and Printed Documentation. 
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The /INCLUDE qualifier is valid only if tag translation is being done. If 
you specify /NOTAG_TRANSLATOR with the /INCLUDE qualifier, VAX 
DOCUMENT issues a warning message stating that you specified an 
illegal combination of command elements. 

/INDEX[=(lndex keyword [,index keyword...])] 
/NOINDEX 

Specifies whether an index file is produced. The /NOINDEX qualifier is 
the default and specifies that no index is produced. When you specify the 
/INDEX qualifier, VAX DOCUMENT creates an index file with a file name 
of input_filename_WTyEK. 

When you place the <INDEX_FILE> tag in your profile file, the current 
index file is included at the corresponding point in the final printable 
output file {filename.filename.FS, and so on). If you do not place the 
<INDEX_FILE> tag in your profile file, the index is not incorporated into your 
final output file, but is placed in the file inputJilenameJLNDKK, which is 
printable separately. 

If you do not specify /INDEX on the command line when you process a file 
that contains an <INDEX_FILE> tag, VAX DOCUMENT issues a warning 
message and the most recent version of the index file that already existed 
is included in your document. This may be an outdated index. If no 
previous index file exists, the device converter issues a warning message. 

The /INDEX qualifier is valid only if text formatting is being done. If 
you specify /NOTEXT_FORMATTER with the /INDEX qualifier, VAX 
DOCUMENT issues a warning message stating that you specified an 
illegal combination of command elements. 

Note that if you process your document with the /NOTAG_TRANSLATOR 
and /INDEX qualifiers, and the index is included using the <INDEX_FILE> 
tag, the index is incorporated into your document, placed in the file 
filenameJINDEX, and processed separately. 

Note: The maximum length of a VMS file name is 39 characters. If you 
want to generate an index file, your input file name must have no 
more than 33 characters, because appending _INDEX to it adds 6 
more characters. 

The following list describes the optional indexing ke 5 rwords that you can 
use with the /INDEX qualifier. For more information on creating and 
generating a single-document and a master index, see the <x>, <XS>, and 
<Y> tag descriptions. 
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Index Keyword 

f GUIDE_HEADINGS 
I NOGUIDE_HEADINGS 


r NONALPHA=AFTER ] 

[, < NONALPHA=BEFORE > ] ) 
I NONALPHA=IGNORE J 


f OVERRIDE_MASTER \ 
\ NOOVERRIDE_MASTER J 


Description 

Specifies whether alphabetic headings are created for each letter 
group in the index. (The entries beginning with “A” have an A 
at the start of the group, and so on.) The GUIDE_HEADINGS 
keyword is the default. The NOGUIDE_HEADINGS keyword 
suppresses guide headings in the index output file, 

Specifies the sorting method used to order entries in an index. 

• SORT=LETTER sorts the entry letter by letter and ignores 
spaces and hyphens. SORT=LETTER is the default. 

• SORT=WORD sorts the entry letter by letter and treats 
spaces and hyphens as significant. 

• SORT=NONALPHA positions an entry with leading 
nonalphabetic characters in the index based on the keyword 
supplied with the NONALPHA keyword. 

— The AFTER keyword causes an entry with leading 
nonalphabetic characters to be placed at the end of the 
index. 

— The BEFORE keyword causes an entry with leading 
nonalphabetic characters to be placed at the beginning 
of the index. 

— The IGNORE keyword causes an entry with leading 
nonalphabetic characters to be sorted by the first 
alphabetic characters in the entry. The default is 
NONALPHA=IGNORE. 

Specifies the inclusion of index entries in both single-document 
indexes and master indexes; NOOVERRIDE_MASTER is 
the default keyword for both /INDEX and /MASTERJNDEX. 
OVERRIDE_MASTER and NOOVERRlDE_MASTER have no 
effect for Bookreader output. 

• Use /INDEX=NOOVERRIDE_MASTER to create a single¬ 
document index that contains only the index entries that are 
not marked with the MASTER keyword; this is the default. 

• Use /INDEX=OVERRIDE_MASTER to create a single¬ 
document index that contains both the index entries that are 
not marked with the MASTER keyword and the entries that 
are marked with the MASTER keyword. 

• Use /MASTERJNDEX=NOOVERRIDE_MASTER to create 
a master index that contains only the index entries that are 
marked with the MASTER keyword; this is the default. 

• Use /MASTERJNDEX=OVERRIDE_MASTER to create a 
master index that contains both the index entries that are not 
marked with the MASTER keyword and those entries that are 
marked with the MASTER keyword. 


/KEEP[=(filetype keyword [,filetype keyword...] )] 
/NOKEEP 

Specifies whether all intermediate files are kept or deleted. The default 
qualifier /NOKEEP indicates that the intermediate files are deleted by 
VAX DOCUMENT after processing. 
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You can use the following ke 3 rwords to specify individual intermediate files 
that are to be kept: 


File Type 
Keyword 

File Contents 

DVI 

Specifies an intermediate output file from the text formatter. You may 
want to keep this file for reprocessing at a later date, or to process 
and print only certain pages. 


The actual file type is based on the destination you specified on the 
DOCUMENT command line. These file types and the destination 
keywords that create them are listed under the description of the 
/TEXT_FORMATTER qualifier. 

INX 

Specifies an ASCII file that contains index entries in page-number 
order. You can use this file to create a master index. 

TEX 

Specifies an input file for the text formatter. Note that a TEX 
file processed with a certain doctype can produce errors if it is 
reprocessed with a different doctype. 


/UST[=file-name] 

/NOLIST 

Specifies whether a listing file is produced. The /NOLIST qualifier is the 
default and suppresses the generation of a hsting file. If you do not specify 
a file specification as an argument to the /LIST qualifier, a listing file is 
produced with the file name of the input file specification and a default 
file type of LIS. If you specify a file specification as an argument, that file 
specification is used as the output file. 

The listing file contains the following information: 

• All messages generated by the tag translator 

• All messages generated by the text processor 

• All messages generated by the device converter 

• A brief summary section. This summary includes the following 
information: 

— The original command line 
— The time and day that processing began 
— The total CPU time used 

If you are running DOCUMENT as a batch job and want a complete log 
file (including output jfrom your LOGIN.COM, symbol definitions, and so 
on), you should use the /LOG qualifier instead of the /LIST qualifier. Do 
not use /LOG, however, if you are using the symbol generator. 

/LOG 

/NOLOG 

Specifies whether informational messages are issued during processing. 
The /LOG qualifier is the default and specifies that informational messages 
are issued. The /NOLOG qualifier suppresses informational messages. 
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The following example shows the typical informational messages displayed 
during tag translation: 

$ DOCUMENT myarticle ARTICLE LN03 
%DOC-I-IDENT, VAX DOCUMENT V2.0 
[Tag Translation]... 

%TAG-I-DEFSLOADD, End of Loading of Tag Definitions 
%TAG-I-ENDPASS_1, End of first pass over the input 
[Text Formatting]... 

If you are running DOCUMENT as a batch job and do not need a complete 
log file (including output from your LOGIN.COM, symbol definitions, and 
so on), you can use the /LIST qualifier instead of the /LOG qualifier. 

/MAP[=file spec] 

/NOMAP 

Specifies whether all the input files processed by VAX DOCUMENT are 
listed in a file. This file starts with the SDML input file and includes the 
tag table and any SDML files specified by the /INCLUDE or /SYMBOLS 
qualifier or the <ELEMENT> or <INCLUDE> tags. Files that are included by 
other files are indented imder those files in this listing. The default file 
type is MAP_LIS. The default qualifier is /NOMAP. 

The /MAP qualifier is valid only if tag translation is being done. If 
you specify /NOTAG_TRANSLATOR with the /MAP qualifier, VAX 
DOCUMENT issues a warning message stating that you specified an 
illegal combination of command elements. 

/MASTER_INDEX[=(index keyword [jindex 
keyword...])] 

/NOMASTERJNDEX 

Causes indexing files to be collated into a master index file. 

When you specify the /MASTERJNDEX qualifier, VAX DOCUMENT 
expects a master index data file as the input file. This data file lists the 
index output (INX) files generated from the individual books that are being 
referenced in the master index. The default file type of this input file is 
INX.LIST. 

This qualifier accepts the same optional indexing keywords as the /INDEX 
qualifier. See the description of the /INDEX qualifier for a list of these 
ke 5 rwords and their uses. 

This qualifier has no effect for Bookreader output. For more information 
on generating a master index, see VAX DOCUMENT Producing Online 
and Printed Documentation. 

/OUTPUT=file spec 

Specifies a new name for the output file. If you do not use the /OUTPUT 
qualifier, the output file is given the same file name as the input file, but 
with a file type based on the other qualifiers and destination chosen. 

An example of a command line that uses the /OUTPUT qualifier follows: 

$ DOC somefile LETTER LN03 /NOTEXT_FORMATTER /OUTPUT=anotherflie 

This command line creates the file ANOTHERFILE.TEX, because 
processing was completed before the text formatter was run. If you omit 
/NOTEXT_FORMATTER from the preceding command line, the output file 
is ANOTHERFILE.LN03. 
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The following table lists the output file types and the default destination 
keywords that produce them. 


Default Destination Keyword 

Default File Type 

BOOKREADER 

DECW$BOOK 

HELP 

HLP 

LINE 

LINE 

LN03 

LN03 

MAIL 

TXT 

PS 

PS 

TERMINAL 

TERM 


/PRINT[=(qualifier keyword [,qualifier keyword...])] 
/NOPRINT 

Specifies whether the output file is printed. /NOPRINT is the default. 

You can use any of the DCL PRINT command qualifiers as keywords to 
the /PRINT qualifier. For example, if you want to print two copies of a 
VAX DOCUMENT file wdth no flag page, you can use the PRINT command 
as follows: 

$ PRINT/NOFLAG/COPIES=2 somefile.line 

You can specify the same options using the following /PRINT qualifier on 
the DOCUMENT command line: 

$ DOC/NOTAG/NOTEXT/NODEV somefile - 
_$/PRINT=(NOFLAG,COPIES=2) LETTER LINE 

You can double-space your output, but only for monospaced destinations: 
LINE, MAIL, and TERMINAL. For example, the following command 
produces double-spaced MAIL output: 

$ DOCU somefile.mail MAIL MAIL/PRINT=SPACE 

You can enter multiple arguments to the /PRINT qualifier ke 5 word on the 
DOCUMENT command line by enclosing the arguments in three pairs of 
quotation marks. For example: 

$ DOCU somefile.sdml SOFT.REF PS - 

_$\PRINT=(NOTIFY,PARAMETER="""(MESSAGE=PRINT, - 

_$DATA=POSTSCRIPT)""", QUEUE=PS_PRINT) 

Default print queues for each of the destination kejrwords available at your 
site are established when VAX DOCUMENT is installed. These queues 
include all DCL PRINT command qualifiers needed for correct printing on 
that output device. 

If you choose to specify a print queue other than SYS$PRINT, the default, 
you must also specify the correct qualifier keywords needed for that 
queue. These keywords vary depending on the type of file you want to 
print (indicated by the file extension) and the type of output device. The 
following table shows the keywords to use for each file and output device 
combination. 
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Output 

File Type 

Print 

Device 

DOCUMENT /PRINT Qualifier-Keywords 

LINE 

Line Printer 

LN03 Laser Printer 

LN03 PLUS Laser Printer 

/PRINT=(QUEUE=queuename) 


LN03R ScriptPrinter 
PrintServer 40 

/PRlNT=(QUEUE=queuename) 

LN03 

LN03 Laser Printer 

LN03 PLUS Laser Printer 

/PRINT=(QUEUE=queuename) 


LN03R ScriptPrinter 
PrintServer 40 

/PRINT=(QUEUE=queuename) 

PS 

LN03R ScriptPrinter 
PrintServer 40 

/PRlNT=(QUEUE=queuename) 


If you want to print your file using the DCL PRINT command, the 
following table shows the qualifiers you must use for each supported 
device. 


Output 

File Type 

Print 

Device 

DCL PRINT Command Qualifiers 

LINE 

Line Printer 

LN03 Laser Printer 

LN03 PLUS Laser Printer 

$ PRINT filename.LINE 
_$ /QUEUE=queuename 


LN03R ScriptPrinter 
PrintServer 40 

$ PRINT/PARAM=(DATA_TYPE=ANSI) filename.LINE 
_$ /QUEUE=queuename 

LN03 

LN03 Laser Printer 

LN03 PLUS Laser Printer 

$ PRINT/NOFEED/PASSALL filename.LN03 
_$ /QUEUE=queuename 


LN03R ScriptPrinter 
PrintServer 40 

$ PRINT/PARAM=(DATA_TYPE=ANSI) filename.LN03 
_$ /QUEUE=queuename 

PS 

LN03R ScriptPrinter 
PrintServer 40 

$ PRINT/PARAM=(DATA_TYPE=POST) filename.PS 
_$ /QUEUE=queuename 


Note that if any serious errors are encountered during processing, the file 
is not sent to the print device. 

/PROFILE=file spec 

Specifies that the input file is a book element and that a cross-reference 
data file previously created by a VAX DOCUMENT bookbuild be used to 
resolve any cross references in the input file. Specify the cross-reference 
data file as an argument to the /PROFILE qualifier; it has a file type of 
XREF. For more information on using the /PROFILE qualifier, see VAX 
DOCUMENT Producing Online and Printed Documentation. 

The /PROFILE qualifier is valid only if tag translation is being done. If 
you specify /NOTAG_TRANSLATOR with the /PROFILE qualifier, VAX 
DOCUMENT issues a warning message stating that you specified an 
illegal combination of command elements. 
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/SYMBOLS=file spec 
/NOSYMBOLS 

Controls whether a file of symbol definitions is read automatically during 
tag translation. The default qualifier is /NOSYMBOLS. The SDML input 
file accessed through the /SYMBOLS qualifier should contain only symbol 
definitions created by the <define_SYMBOL> and the <define_BOOK_NAME> 
tags. You can use the /SYMBOLS qualifier on the command line only 
once. For more information on using the /SYMBOLS qualifier, see VAX 
DOCUMENT Producing Online and Printed Documentation. 

The /SYMBOLS qualifier is valid only if tag translation is being done. If 
you specify /NOTAG.TRANSLATOR with the /SYMBOLS qualifier, VAX 
DOCUMENT issues a warning message stating that you specified an 
illegal combination of command elements. 

/TAGJTRANSLATOR 

/NOTAGJTRANSLATOR 

Controls whether the tag translator is run. If you do not specify this 
qualifier, the default qualifier is /TAG_TRANSLATOR. 

By default, the tag translator produces an output file with the file name 
of the input file and a file type of TEX. You can then use this file as an 
input file to the text formatter. Using /NOTAG_TRANSLATOR excludes 
tag translation and the following related qualifiers: /CONDITION, 
/ELEMENT, /DIAGNOSTICS, /INCLUDE, /MAP, /PROFILE, and 
/SYMBOLS. For more information on using the /TAG_TRANSLATOR 
qualifier, see VAX DOCUMENT Producing Online and Printed 
Documentation. 

/TEXT_FORMATTER 

/NOTEXT_FORMATTER 

Controls whether the text formatting program is run. If you specify 
/NOTEXT_FORMATTER, VAX DOCUMENT processing stops after the 
tag translator completes, and text formatting and the following related 
qualifiers are excluded: /CONTENTS and /INDEX. /TEXT_FORMATTER 
is the default. 

If you specify /NOTAG_TRANSLATOR and the input file you specify on 
the command hne does not include a file type, the default file type is TEX. 
The output file from the text formatter can have one of several file types 
based on the destination entered on the command line. These default 
output file types and their related destination ke5rwords are given in the 
following list. 


Destination Intermediate Final 

Keyword Output File Type Output File Type 


BOOKREADER DVLBOOKREADER 
HELP None. 

LINE DVLLINE 

LN03 DVI_LN03 

MAIL DVI LINE 


DECW$BOOK 

HLP 

LINE 

LN03 

TXT 
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Destination 

intermediate 

Finai 

Keyword 

Output File Type 

Output Fiie Type 

PS 

DVI_PS 

PS 

TERMINAL 

DVLLINE 

TERM 


You can then use the output file from the text formatter as an input file to 
the device converter. 


EXAMPLE When you process your input file using the DOCUMENT command, you 

are actually running your file through several processors. The following 
example shows a typical use of the VAX DOCUMENT command: 

$ DOCUMENT myreport.SDML REPORT LN03 /CONTENTS 

%DOC-I-IDENT, VAX DOCUMENT V2.0 
[Tag Translation]... 

%TAG-I-DEFSLOADD, End of Loading of Tag Definitions 
%TAG-I-ENDPASS_1, End of first pass over the input 
[Text Formatting]... 

%TEX-I-PAGESOUT, 17 pages written. 

-TEX-I-OUTFILENAME, 'DUAl:[DOCFILES]MYREPORT.DVI_LN03' 

[Contents Generation]... 

[Text Formatting Contents]... 

%TEX-I-PAGESOUT, 1 page written. 

-TEX-I-OUTFILENAME, 'DUAl:[DOCFILES]MYREPORT_CONTENTS.DVI_LN03' 

[Device Conversion]... 

%DVC-I-PAGESOUT, 18 pages written to file: 

DUAl:[DOCFILES]MYREPORT.LN03 

[Contents Device Conversion]... 

%DVC-I-PAGESOUT, 1 page written to file: 

DUAl:[DOCFILES]MYREPORT_CONTENTS.LN03 
[Printing File]... 

Job MYREPORT (queue SYS$LN03, entry 833) started on SYS$LN03 
[Printing Contents]... 

Job MYREPORT_CONTENTS (queue SYS$LN03, entry 834) started on SYS$LN03 

$ 
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DOCUMENT/GENERATE_SYMBOL 

Starts the VAX DOCUMENT symbol generator. 

FORMAT 

DOCUMENT/GENERATE SiimOLl/USTl=file-name]] 

[/PREFIX= 

prefix-name] 

input-file 


Command Qualifier Default 

/LISTHile-name] /NOLIST 

/PREFIX=prefix-name Up to 25 characters of the input-file. 

restrictions 

The /GENERATE_SYMBOL command must immediately follow the 
DOCUMENT command. 

PARAMETERS 

input-file 

Specifies the input file to be processed. You cannot use wildcards in the 
input file specification. 

The default file type of the input file is SDML. 


DESCRIPTION DOCUMENT/GENERATE_SYMBOL is the command you specify to start 

the symbol generator. It requires one parameter: 


• Input File 

Specifies the input file for the symbol generator. By default, this file is 
an SDML file containing SDML tags. 

The s3nnbol name that is created consists of a prefix that you supply, with 
an appended sequential number that VAX DOCUMENT generates. VAX 
DOCUMENT creates a new version of the SDML file with symbol names 
added to tags that did not already have symbol names. The original SDML 
file is not deleted. 

You can use the symbol generator on your profile file. You can also use the 
symbol generator on SDML files that use the <INCLUDE> tag; the symbol 
generator adds symbols to any file that VAX DOCUMENT includes with 
the <INCLUDE> tag. 

For information on how to use the symbol generator, see VAX DOCUMENT 
Producing Online and Printed Documentation. 
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QUALIFIERS 


/UST[=file name] 

/NOLIST 

Specifies whether a listing file is produced. The /NOLIST qualifier is the 
default and suppresses the generation of a listing file. If you do not specify 
a file specification as an argument to the /LIST qualifier, a listing file is 
produced with the file name of the input file specification and a default 
file type of LIS. If you specify a file specification as an argument, that file 
specification is used as the output file. 

The listing file contains the following information: 

• All messages generated by the tag translator 

• A brief summary section. This summary includes the following 
information: 

— Original command line 
— Time and day that processing began 
— Total CPU time used 

/PREFIX=prefix-name 

Specifies the prefix you want appended to each symbol name in your file, 
including any included files. If you do not specify a prefix-name, a default 
prefix of up to 25 characters of the input-file name is used. If the input-file 
exceeds a length of 25 characters, the remaining characters are truncated. 
Any alphanumeric character is valid. Invalid characters are changed to 
underscores only when the default prefix is used. 

For example, you could use the following command: 

$ DOCUMENT/GENERATE_SYMBOL/LIST/PREFIX=ABC MYFILE.SDML 
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A message has the following format; 

% facility—severity—identification, text 

Messages in VAX DOCUMENT can come from the following facilities: 


Facility code 

Facility 

DOC 

The DOCUMENT command line 

TAG 

The tag translator 

TEX 

The text processor 

DVC 

The device converter 

INX 

The index facility 


The messages from these sources are given in the following sections. 

To locate a message, use the facility code to locate the appropriate section 
and then look for the identification text in that section. Messages are 
alphabetical within sections. 

For example, consider the following message; 

%TAG-W-ISTHISTAG, at text on line 245 in file 
WRT_:[YOURNAME.BOOK]INTRO.SDML; 

Ignoring <list. Is this a tag without a closing angle bracket? 

The facility code in this error is TAG, so you look in the section for tag 
translator message. The identification text is ISTHISTAG, so you locate 
that within the section. 
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B.1 DOCUMENT Command Messages 

ACTION_EXCL, qualifier is not available for the chosen destination 

Warning: Indicates that the default qualifier has been excluded for the 
desired destination and will therefore be ignored. 

User Action: None. 

AMB_DESIGN, Ambiguous design keyword design-keyword 

Fatal: An ambiguous design keyword was specified. 

User Action: Change the specified design keyword to be a unique design 
ke3word. 

AMB_DEST, Ambiguous destination keyword destination-keyword 

Fatal: An ambiguous destination keyword was specified. 

User Action: Change the specified destination ke 5 rword to be a unique 
ke5rword. 

AMB_PAPER_SIZE, Ambiguous paper size value 

Error: The specified paper size value is ambiguous. 

User Action: Specify a unique paper value and reexecute the 
DOCUMENT command. 

CANT_GET_VALUE, Cannot get value of /qualifier qualifier 

Fatal: A required value associated with the qualifier was not provided. 

User Action: Specify a value for the qualifier and reexecute the 
DOCUMENT command. 

CANT_OPEN, Error detected opening file file-spec 

Error: An error has occurred while opening the specified file. 

User Action: Correct the error if you can or refer the problem to your 
system manager. After fixing the problem, reexecute the DOCUMENT 
command. 

CANT_USE_SHR, Cannot use file-spec 

Fatal: A shareable image file for text processing could not be found or 
used. 

User Action: Consult your system manager. 

DCL_ERROR, An error was detected while parsing 
\DCL-command\ 

Error: An error was detected by the DCL parser. 

User Action: Correct the error on the specified line and reexecute the 
DOCUMENT command. 
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DESIGN_ERROR, Bad design entry in design-file-directory DOC$DESIGNS 
data file 

Error: An error was found in a design data file; erroneous design entries 
are ignored. 

User Action: Correct the error and reexecute the DOCUMENT command. 

DESIGN_SYNTAX, Ignoring design-keyword design entry 
Error: A sjmtax error is detected in the design data file. 

User Action: Correct the error and reexecute the DOCUMENT command. 

DEST_ERROR, Bad destination entry in destination-file-directory 
DOC$DESTINATIONS data file 

Error: An error was found in a destination data file. Any involved entries 
are ignored. 

User Action: Correct the error and reexecute the DOCUMENT command. 

DEST_SYNTAX, Ignoring destination-keyword destination data entry 

Error: An error has been detected in a destination data file. 

User Action: Correct the errors in the destination data file and reexecute 
the DOCUMENT command. 

DO_CONTENTS, [ContentsGeneration ]... 

Informational: Indicates that a contents file is being created. 

User Action: None. 

DO_DEVICE, [DeviceConversion ]... 

Informational: Indicates that the document input is being processed into 
a printable form. 

User Action: None. 

DO_DVC_CONTENTS, [ContentsDeviceConversion ]... 

Informational: Indicates that the document contents is being processed 
into a printable form. 

User Action: None. 

DO_DVC_INDEX, [IndexDeviceConversion ]... 

Informational: Indicates that the document index is being processed into 
a printable form. 

User Action: None. 

DO_INDEX, [IndexGeneration ]... 

Informational: Indicates that an index file is being created. 

User Action: None. 
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DO_MASTER_INDEX, [MasterIndexGeneration ]... 

Informational: Indicates that a master index file is being created. 

User Action: None. 

DO_PRINT, [PrintingFile ]... 

Informational: Indicates that your output file is being sent to the 
designated print queue. 

User Action: None. 

DO_TAG, [TagTranslation ]... 

Informational: Indicates that the tag translator is processing your SDML 
input file. 

User Action: None. 

DO_TEXT, [TextFormatting ]... 

Informational: Indicates that the text formatter is processing. 

User Action: None. 

DO_TEXT_CONTENTS, [TextFormattingContents ]... 

Informational: Indicates that the text formatter is processing the 
contents file. 

User Action: None. 

DO_TEXT_INDEX, [TextFormattingIndex ]... 

Informational: Indicates that the text formatter is processing the index 
file. 

User Action: None. 

ERROR_CONVERTER, Errors found by the device converter 

Error: The device converter has ended in error; processing cannot 
continue. 

User Action: Correct the errors found by the device converter and 
reexecute the DOCUMENT command. 

ERROR_FORMATTER, Errors found by the text formatter 

Error: The text formatter has ended in error; processing cannot continue. 

User Action: Correct the errors found by the text formatter and reexecute 
the DOCUMENT command. 

ERROR_INDEXER, Errors found by the indexing facility 

Error; The indexing facility has ended in error; processing cannot 
continue. 

User Action: Correct the errors found by the indexing facility and 
reexecute the DOCUMENT command. 
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ERROR_IN_DESIGN, Internal design date file error 

Fatal: An unspecified error in the design data file was found. 

User Action: Refer the problem to your system manager. If you receive 
this message and are under a service contract with Digital, call your 
customer service center. Otherwise, submit a Software Performance 
Report. 

ERROR_IN_DEST, Internal destination data file error 

Fatal: An unspecified error in the destination data file was found. 

User Action: Refer the problem to your system manager. If you receive 
this message and are under a service contract with Digital, call your 
customer service center. Otherwise, submit a Software Performance 
Report. 

ERROR_TAG, Errors found by the tag translator 

Error: The tag translator has ended in error; processing cannot continue. 

User Action: Correct the errors found by the tag translator and reexecute 
the DOCUMENT command. 

ERROR_WRITE, Error writing to file file-spec 

Fatal: An RMS error was reported when DOCUMENT tried to read the 
specified file. 

User Action: Correct the RMS error and reexecute DOCUMENT 
command. 

ERR_CRE8_LIST, Listing file file-spec cannot be created 
Fatal: The specified listing file could not be created. 

User Action: Correct the error in the listing file specification. 

FILLM_TOO_LOW, Process open file limit too low, required value is 
minimum-value 

Fatal: The FILLM of the current process in not large enough to run the 
DOCUMENT command. 

User Action: Contact you system manager to increase the quota. 

IDENT, VAX DOCUMENT version number 

Informational: DOCUMENT version number identification message. 
User Action: None. 

IGNOR_DESIGN, Ignoring optional logical-name design data file 

Informational: Optional DOC$LOCAL_FORMATS or DOC$STANDARD_ 
FORMATS design file cannot be opened. Any designs that are in that file 
will be unavailable. 

User Action: Correct the problem and reexecute the DOCUMENT 
command or contact your system manager. 
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INVALID_DESIGN, design-keyword is not a valid design 

Fatal: An unrecognized design parameter was specified on the 
DOCUMENT command line. 

User Action: Specify a valid design parameter and reexecute the 
DOCUMENT command. 

INVALID_DEST, destination-keyword is not a valid destination 

Fatal: An unrecognized destination ke5rword was specified on the 
DOCUMENT command line. 

User Action: Specify a valid destination keyword and reexecute the 
DOCUMENT command. 

INVALID_DVI_ARG, qualifier-arg is not a valid /DEVICE_CONVERTER 
argument 

Fatal: The argument value specified to /DEVICE_CONVERTER is 
unrecognized. 

User Action: Specify a valid qualifier argument and reexecute the 
DOCUMENT command. 

INVALID_ENTRY, qualifier-entry is not a valid /qualifier entry 

Fatal: An invalid qualifier entry was specified on the DOCUMENT 
command. 

User Action: Specify a valid qualifier and reexecute the DOCUMENT 
command. Refer to Appendix A in this manual for information about valid 
DOCUMENT command qualifiers. 

INVALID_INPUT, Cannot use file-spec as an input file 
Fatal: The specified input file is invalid. 

User Action: Specify a valid input file specification and reexecute the 
DOCUMENT command. 

INVALID_VALUE, Cannot use file-spec as a file for /qualifier 

Fatal: The specified input file associated with the qualifier cannot be 
opened. 

User Action: Specify a valid input file specification and reexecute the 
DOCUMENT command. 

NEED_VALUE, Destination entry parameter command needs AALUE or a 
keyword 

Error: S3mtax error found when parsing the destination data file. 

User Action: Refer the problem to your system manager. If you receive 
this message and are under a service contract with Digital, call your 
customer service center. Otherwise, submit a Software Performance 
Report. 


B-6 



Messages 

DOCUMENT Command Messages 


NOMASTER_DEST, Chosen destination does not allow /MASTER_INDEX 
processing 

Fatal: Master index processing is not allowed for the destination specified 
in the DOCUMENT command. 

User Action: Either remove /MASTER_INDEX from the DOCUMENT 
command or choose another destination, and reexecute the DOCUMENT 
command. 

NO_CONTENTS, No contents; /CONTENTS qualifier unnecessary 

Warning: No contents information was available to generate a contents 
file; no contents file will be produced. 

User Action: Do not use the /CONTENTS qualifier when processing this 
input file. An SDML file must contain at least one <CHAPTER>, <APPENDIX>, 
or <HEADn> tag to produce a table of contents file. 

NO_INDEX, No index; /INDEX qualifier unnecessary 

Warning: No index information was available to generate an index file; 
no index file will be produced. 

User Action: Do not use the /INDEX qualifier when processing this input 
file. An SDML file must contain at least one <X> or <Y> tag to produce an 
index file. 

OPEN.DESIGN, Error opening design data file in DOC$STANDARD_ 
FORMATS 

Fatal: An error occurred when trying to open the DOC$STANDARD_ 
FORMATS:DOC$DESIGNS.DAT data file. 

User Action: Check for the existence of the DOC$STANDARD_ 
FORMATS:DOC$DESIGNS.DAT data file. If it exists, then check the 
file protection on that file. 

OPEN_DEST, Error opening 

DOC$STANDARD_FORMATS:DOC$DESTINATIONS data 
file 

Fatal: There was a RMS error when trying to open the destination data 
file. 

User Action: Check for the existence of the DOC$STANDARD_ 
FORMATS:DOC$DESTINATIONS.DAT data file. If it exists, then check 
the file protection on that file. 

PGFLQ_TOO_LOW, Process paging file quota too low, required value is 
minimum-value 

Fatal: The PGFLQUOTA of the current process is not large enough to run 
the DOCUMENT command. 

User Action: Contact your system manager to increase the quota. 
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PRINT_CONTENTS, [PrintingContents ]... 

Informational: Indicates that your contents file is being sent to the 
designated print queue. 

User Action: None. 

PRINTJNDEX, [Printingindex ]... 

Informational: Indicates that your index file is being sent to the 
designated print queue. 

User Action: None. 

PROB_CRE_LOGIC, A problem was encountered creating logical name 
logical-name 

Error: An error was returned when VAX DOCUMENT attempted to 
create a VMS process logical name. 

User Action: Correct the error if you can or refer the problem to your 
system manager. After fixing the problem, reexecute the DOCUMENT 
command. 

THESE_DESIGNS, Choose one of these designs: 

Informational: Inquires for choice of document design types, this is 
required input to the DOCUMENT command. 

User Action: At the prompt, type the desired design from the choices 
offered. 

THESE_DESTS, Choose one of these destinations: 

Informational: Inquires for your choice of document destinations. This is 
required input the DOCUMENT command. 

User Action: At the prompt, type the desired destination from the choices 
offered. 

TYPEJNPUT, input file 

Informational: Inquires for the input file. 

User Action: At the prompt, type the name of the input file. 

UNR_DESIGN, Unrecognized design - please check your spelling 

Fatal: An unrecognized design parameter has been specified to the 
DOCUMENT command. 

User Action: Specify a valid design parameter and reexecute the 
DOCUMENT command. 

UNR_DEST, Unrecognized destination - please check your spelling 

Fatal: An unrecognized destination parameter has been specified to the 
DOCUMENT command. 

User Action: Specify a valid destination parameter and reexecute the 
DOCUMENT command. 
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Tag Translator Messages 

ABORTFORE, at tag or text, line n, file 
file-spec 

There have been more than number error messages of severity 
level E 

Fatal: The tag translator did not produce an output file because it 
detected too many errors in the SDML source file with a severity level of 
Error. SDML defines the minimum number of error messages of severity 
E as 0, although this default value can be modified in local usage. 

User Action: Examine the output from the preceding messages to 
determine the errors you must correct. 

ABORTFORW, at tag or text, line n, file 
file-spec 

There have been more than number error messages of severity 
level W 

Fatal: The tag translator did not produce an output file because it 
detected too many errors in the SDML source file with a severity level 
of Warning. SDML defines the minimum number of error messages of 
severity W as 30, although this default value can be modified in local 
usage. 

User Action: Examine the output from the preceding messages to 
determine the errors you must correct. 

ARGBADOPR, at tag or text, line n, file 
file-spec 

Argument 2 to tag <COUNTER> has an illegal arithmetic 
operator 

Warning: The tag translator has found an illegal operator. The second 
argument to the <COUNTER> tag consists of pairs of operators and 
operands, and an optional trailing comment. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

I ARGINCMPL, at tag or text, line n, file 

file-spec 

Argument 2 to tag <COUNTER> is incomplete 

Warning: The tag translator has not found at least one operator and one 
operand. The second argument to the <COUNTER> tag requires at least one 
j operator and one operand. 

User Action: If you receive this message and are under a service contract 
J with Digital, call your customer service center. Otherwise, submit a 

Software Performance Report. 
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AEGINVALD, at tag or text, line n, file 
file-spec 

Argument number to tag <tagname> is an invalid argument. 

Warning: The argument in the specified position is not valid for the 
specified tag. 

User Action: Verify the tag’s argument and correct it. 

ARGMENTIS, The argument is string 

Informational: Follows a message that indicates that an argument 
is invalid, for example, when a numeric argument is required, but a 
character string argument is specified. 

User Action: Use the information to correct your source file. 

ARGMISSNG, at tag or text, line n, file 
file-spec 

Argument number to tag <tagname> is missing 

Warning: The tag translator found no text for the indicated argument, 
but the argument is required for the indicated tag. 

User Action: Supply a value for the indicated argument. 

ARGNOTCHR, at tag or text, line n^ file 
file-spec 

Argument to tag <CHR> is not in the range 32 to 126 

Warning: The <CHR> built-in tag requires a numeric argument whose 
value is in the range of 32 to 126. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

ARGNOTKEY, at tag or text, line n, file 
file-spec 

Argument number to tag <tagname> is not a keyword 

Warning: The argument in the indicated position is not a valid keyword 
argument for the indicated tag. This message is generally followed by a 
message that shows the keyword that was specified. 

User Action: Using the information in this message and the 
accompanying message, determine the keyword in error. Determine 
the valid arguments for the tag in question and correct your source file. 

ARGNOTLET, at tag or text, line n, file 
file-spec 

Argument to tag <SET_APPENDIX_LETTER> is not a letter 

Warning: The <SET_APPENDIX_LETTER> tag requires a letter (A to Z). 

User Action: Correct the source file to supply a letter as the first 
character of the argument. 
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ARGNOTMSG, at tag or text, line n, file 
file-spec 

Argument number to tag <tagname> is not a valid message 
code 

Warning: The indicated argument to the <TAG_DIAGN0STIC> built-in tag is 
not a recognized message code. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

ARGNOTNAM, at tag or text, line n, file 
file-spec 

Argument number to tag <tagname> is not a valid name 

Warning: The indicated argument does not obey the rules for formation 
of a name. A name must have only letters, digits, and the underscore 
character. A name must not begin with two underscores. Spaces, tabs, 
and carriage returns are not allowed. 

User Action: Correct the argument so that the name is valid. 

ARGNOTNUM, at tag or text, line n, file 
file-spec 

Argument number to tag <tagname> is not a number 

Warning: A non-numeric argument was specified to a tag that requires a 
numeric argument. 

User Action: Verify that the argument is in the correct position in the 
tag’s argument list. Supply a numeric argument to the tag. 

ARGNOTPOS, at tag or text, line n, file 
file-spec 

Argument to tag <tagname> is not a positive integer 

Warning: The <set_chapter_number> and <set_appendix_number> tags 
require a positive integer for the chapter or appendix number argument. 

User Action: Correct the source file to supply a positive integer. 

ARGNOTQUA, at tag or text, line n, file 
file-spec 

Argument to tag does not begin with a slash 

Error: The argument to the <QUALITEM> tag must be a valid VMS 
qualifier, that is, it must begin with a slash. 

User Action: Correct the source file to supply a slash character. 

ARGNOTVAL, Argument number to tag <tagname> is not an integer from 
1 to 6 


Warning: Numeric argument must be an integer from 1 to 6. 
User Action; Supply an integer from 1 to 6. 
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AEGNOTTYP, at tag or text, line n, file 
file-spec 

Argument string to tag <tagname> is not valid for doctype 
string 

Warning; The indicated argument is not valid for this tag in the indicated 
doctype. 

User Action: Verify that you specified the correct doctype keyword on the 
DOCUMENT command line. 

AKGOUTRAN, at tag or text, line n, file 
file-spec 

Argument number is not in the range 0 to 9 

Warning; The indicated argument cannot be less than 0 or greater 
than 9. 

User Action; Correct the argument so that the number is in range. 

ARGOVRFLW, at tag or text, line n, file 
file-spec 

More than number characters in an argument 

Fatal: The argument is too large. This often indicates that an argument 
list was not terminated correctly. The tag translator may be including 
large portions of the input text as part of the argument. 

User Action: Check the tag indicated by the location information and 
supply the correct terminator to the argument list. 

AUXOVRFLW, at tag or text, line n, file 
file-spec 

More than number auxiliary files open 

Fatal; The number of auxiliary files that can be open simultaneously is 
limited. 

User Action; If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

BADLSTARG, at tag or text, line n, file 
file-spec 

Argument string is not valid for <LIST> type string 

Warning: Verify the argument you specified to the <LIST> tag. Each type 
of list accepts different keyword arguments, for example, UPPERCASE is 
a valid keyword for alphabetic lists, but not for numbered lists. 

User Action: Verify that you have specified the correct type of list. If you 
specify a keyword argument, be sure you spell it correctly. 
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BKSYMNTDF, at tag or text, line n, file 
file-spec 

Symbol string is undefined. 

Bookshelf will not be created. 

Error: A symbol has been referenced but is not in the symbol table. 

User Action: Verify that you spelled the symbol correctly and that the 
same symbol has been entered in the symbol table. 

BNOTESOUT, at tag or text, line n, file 
file-spec 

Accumulated string not referenced. 

Notes will not be output 

Warning: A document contained <BACK_NOTE> or <BIB_NOTE> tags, but no 
corresponding <BACK_NOTES> or <BIB_N0TES> tag was specified to output 
the accumulated notes. 

User Action: Place the <BACK_NOTES> or <BIB_N0TES> tag in the source 
file at the position at which you want them output. 

BOOL2DEEP, at tag or text, line n, file 
file-spec 

Boolean expression has too many nested parentheses. 

Error: A boolean expression is nested too deep. 

User Action: Correct the boolean expression. 

BOOL_BDCH, at tag or text, line n, file 
file-spec 

Bad character in boolean expression: string 

Warning: Each item in a boolean expression must begin with one of the 
characters A(ND), N(OT), 0(R), T(RUE), F(ALSE) or must be a left or 
right parenthesis. 

User Action: Correct the boolean expression. 

BOOL_BDST, at tag or text, line n, file 
file-spec 

Bad boolean expression, evaluation incomplete 

Warning: At the completion of the evaluation of the boolean expression, 
some work remained to be done. 

User Action: Correct the boolean expression. 

BOOL_EXPN, at tag or text, line n, file 
file-spec 

Bad boolean expression, string precedes string 

Warning: A boolean expression is improperly formed. The two terms 
shown in the error message cannot appear in the order shown. 

User Action: Correct the boolean expression. 
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BOOL_RTPN, at tag or text, line n, file 
file-spec 

Unmatched right parenthesis in boolean expression 

Warning: An extra right parenthesis has been found in a boolean 
expression. 

User Action; Correct the boolean expression. 

BOOL_SPEL, at tag or text, line n, file 
file-spec 

Term in boolean expression misspelled 

Warning; One of the words AND, OR, NOT, TRUE, or FALSE is 
misspelled in the boolean expression. 

User Action; Correct the boolean expression. 

BOOL_TKIN, at tag or text, line n, file 
file-spec 

Last word in boolean expression is incomplete 

Warning; The last word in the boolean expression begins with one of the 
characters A, O, N, T, or F, but is not spelled out completely. 

User Action; Correct the boolean expression. 

BOXTOOBIG, at tag or text, line n, file 
file-spec 

Length number of boxed item exceeds number characters. 

Warning; An argument to the <BOX> tag exceeds the maximum number of 
characters allowed. The text will be output as null. 

User Action: Correct the <BOX> tag to specify an argument with fewer 
characters. 

CALL_NEST, at tag or text, line n, file 
file-spec 

Callouts inaccurately nested in a monospaced example. 

Error; A monospaced example using callouts incorrectly nests 
<EXAMPLE> . . . <ENDEXAMPLE> tags (or tags SUCh as <CODE_EXAMPLE> 
that produce monospaced output) with respect to the <CALLOUTS> . . . 
<ENDCALLOUTS> tags. For example, the following is incorrect: 

<CALLOUTS>(\PREFIX) 

<CODE_EXAMPLE> 

<ENDCALLOUTS> 

<ENDCODE_EXAMPLE> 

User Action; Correct the SDML source file so that the begin and end tags 
for the example and the callouts are correctly nested. For example: 

<CALLOUTS>(\PREFIX) 

<CODE_EXAMPLE> 

<ENDCODE_EXAMPLE> 

<ENDCALLOUTS> 
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CANTOPINT, Cannot open intermediate input file: 
file_spec 

Fatal: The post translator cannot open the INT_TEX file. 

User Action: Verify that the file specification is correct and that you have 
sufficient resources and access rights to open the file. 

CANTOPOUT, Cannot create output file: 
file_spec 

Fatal: The post translator cannot create the TEX file for some reason. 

User Action: Verify that the file specification is correct, and that you 
have sufficient resources and access rights to create the file. 

CASOVRFLW, at tag or text, line n, file 
file-spec 

<CASE> tags have been nested beyond the limit of number 

Fatal: The <CASE> built-in tag has been nested beyond the allowed limit. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

COMNOTEND, at tag or text, line n, file 
file-spec 

A <COMMENT> in a tag definition has not been terminated 

Error: A tag’s definition contains a comment that is not properly 
terminated. 

User Action: Examine the tag definition to be certain that the 
comment text is terminated. If the comment text contains characters 
such as ampersand, backslash, vertical bar, or parentheses, use the 
<COMMENT> . . . <ENDCOMMENT> format. 

CPU_USAGE, Pass 1: number Pass 2: number Total: number seconds 

Informational: The tag translator reports its CPU usage during pass 1 
and pass 2 and the total for both passes. 

User Action: None. 

CPYNAMHID, at tag or text, line n, file 
file-spec 

<COPY_TAG> is referencing a tag {<tagname>) that is hidden 

Warning: The name referenced by the <COPY_TAG> is hidden, and 
therefore cannot be copied as a new tag definition. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 
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CPYNAMUND, at tag or text, line n, file 
file-spec 

<COPY_TAG> is referencing a name {string) that is undefined 

Warning: The name referenced by the <COPY_TAG> is not defined, and 
therefore cannot be copied as a new tag definition. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

DEFSLOADD, End of Loading of Tag Definitions 

Informational: This message is issued after the tag definitions have been 
loaded and before the reading of any input files. If any error messages 
appear before this message, the errors were detected during the loading of 
the tag definitions. 

User Action: None. 

DIVBYZERO, at tag or text, line n, file 
file-spec 

Argument 2 to tag <COUNTER> is attempting to divide by zero 

Warning: Division by zero is undefined. (Processing continues. The result 
is as if a divisor of 1 had been used.) 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

DUPHIDNAM, at tag or text, line n, file 
file-spec 

A <fflDE_TAGS> tag is reusing the hide-name, string 

Warning: The hide-name is already in use. Once tags have been hidden 
under a specific hide-name, that hide-name cannot again be used until the 
tags have been revealed with the <REVEAL_TAGS> tag. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

DUPSYMBOL, at tag or text, line n, file 
file-spec 

The symbol string is being defined twice. 

The earlier definition is replaced by the new definition 

Warning: The same symbol is being defined for two different purposes. 
The tag translator requires that each symbol be unique. If your symbols 
exceed 31 characters in length, the automatic truncation to 31 characters 
may be causing two different s 5 rmbols to look alike. 

User Action: Verify that both S 5 anbols are defined uniquely within the 
first 31 characters. 
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EDIT_CODE, at tag or text, line n, file 
file-spec 

Argument number has illegal action code char 
Error: The character shown is not one of the allowed action codes. 

User Action: Correct the indicated argument to the tag. 

EDIT_LNEQ, at tag or text, line n, file 
file-spec 

Lengths of delimiter, action, substitute strings are not equal 

Error: The number of delimiter characters and the number of action 
codes in one of the action strings or substitute characters in the substitute 
string are not the same. 

User Action: Correct the delimiter, action, or substitute arguments to the 
tag. 

ENDNOTBEG, at tag or text, line n, file 
file-spec 

<tagname> specified without corresponding <tagname>. 

Warning: A terminating tag was specified without the tag that it 
terminates. The tag is ignored. 

User Action: Verify that you correctly entered the beginning tag, or 
remove the extraneous ending tag from your source file. 

ENDPASS_1, End of first pass over the input 

Informational: The tag translator reports the end of the first pass over 
all input files. Error messages that appear ahead of this message were 
issued during the first pass. Error messages that follow this message are 
issued during the second pass over the input files. 

User Action: None. 

EOFARGLST, End of file encountered while searching for closing 

parenthesis. See argument list of tag <tagname> on line 

number of file 

filename 

Fatal: An argument list is not terminated before the end of the current 
input file. Either a right parenthesis is missing or an <INCLUDE> tag 
occurred in a tag’s argument list. 

User Action: Verify that the indicated tag’s argument list is terminated 
and that no tag’s argument list is unterminated at the end of an included 
file. 
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EOFCOLECT, End of file encountered while searching for tag <tagname>. 

See <COLLECT> or <protect> tag on line number of file 
filename 

Fatal: A <COLLECT> or <PROTECT> built-in tag has encountered an end of 
file before encountering the indicated stop-tag. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

EOFENDCAS, End of file encountered while searching for tag <ENDCASE>. 

See <CASE> or <CASE_NUMERIC> tag on line number of file 
filename 

Fatal: A <CASE> (or <CASE_NUMERIC>) built-in tag is not terminated before 
the end of file. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

EOFENDCOM, End of file encountered while searching for tag 
<ENDCOMMENT>. 

See <COMMENT> tag on line number of file 
filename 

Fatal: Comment text, introduced by the <COMMENT> built-in tag, was not 
enclosed as an argument, and therefore requires an <ENDCOMMENT> tag as 
a terminator. 

User Action: Verify that the comment text is either enclosed as an 
argument to the <COMMENT> built-in tag or that it is terminated with an 
<ENDCOMMENT> tag. 

EOFENDLIT, End of file encountered while searching for <ENDLITERAL> 
or <ENDDELAYED>. See <LITERAL> or <DELAYED> tag on line 
number of file 
filename 

Fatal: Literal text, introduced by the <LITERAL> or <DELAYED> tag, was 
not enclosed as an argument, and therefore requires an <ENDLITERAL> or 
<ENDDELAYED> tag as a terminator. 

User Action: Verify that the literal text is either enclosed as an argument 
to the <LITERAL> or <DELAYED> tag or that it is terminated with an 
<ENDLITERAL> or <ENDDELAYED> tag. 

EOFIGNORE, at tag or text, line n, file 
file-spec 

End of file encountered while searching for tag or label 

Fatal: An <IGN0RE> built-in tag has encountered the end of the input file 
without finding one of the tags or labels supplied in the argument list. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 
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ERRCLSINP, at tag or text, line n., file 
file-spec 

Input files not closed at end of pass. 

Fatal: Files that were included as part of the input have not been properly 
closed. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

ERRDEFLNM, at tag or text, line n, file 
file-spec 

Attempt to define logical name was unsuccessful 

Logical: string 

Equivalenceis^rmg 

Warning: An <INCLUDES_FILE> tag in the <PR0FILE> template has failed in 
its attempt to define the logical name with the given equivalence string. 

User Action: Examine the arguments to the <INCLUDES_FIliE> tag to 
ensure that they are a correctly formed name and a file specification. 
Correct the <INCLUDES_FILE> arguments. 

ERRDURGET, at tag or text, line n, file 
file-spec 

Error reading line number of file: 
filename. 

Perhaps the line is too long 

Warning: The indicated line probably exceeds the tag translator’s buffer 
size. Processing continues with a truncated line (which may introduce 
other errors if the information that was lost includes part of an argument 
list to a tag). 

User Action: Edit the input file and shorten the line or break it into two 
lines, if possible. 

ERRDURPUT, at tag or text, line n, file 
file-spec 

Error detected writing output file: 
filename 

Fatal: An error was detected while attempting to write to the indicated 
output file. 

User Action: Check that your process has sufficient privilege and access 
rights and that the output device has sufficient free space to hold the file. 

ERROPEAUX, at tag or text, line n, file 
file-spec 

Cannot open auxiliary file: 
filename 
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Warning: An attempt to open an auxiliary file failed. The next 
Informational message may supply the reason for the failure. Processing 
continues, but attempts to read or write the auxiliary file will fail and will 
generate error messages. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

ERROPEDMP, at tag or text, line n, file 
file-spec 

Cannot open dump file: 
filename 

Warning: The <RETRIEVE> built-in tag has failed to open a file for output. 
The next Informational message may indicate the reason for the failure. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

ERROPEINC, at tag or text, line n, file 
file-spec 

Cannot open included file; 
filename 

Warning: The indicated file cannot be opened for input. The next 
Informational message may indicate the reason for the failure. Processing 
continues without the included file. 

User Action: Verify that the correct file is being accessed and can be 
read. If you are using a logical name to access the file, verify that the 
logical name is defined. If you are relying on an <INCLUDES_FILE> tag to 
define the logical name, verify that the spelling of the logical name is the 
same in the <INCLUDES_FILE> tag, and that the <INCLUDES_FILE> tag has 
been specified for the book element that contains the <INCLUDE> tag. 

ERROPEINP, at tag or text, line n, file 
file-spec 

Cannot open input file: 
filename 

Fatal: The input file specified on the command line cannot be opened. 

The next Informational message may indicate the reason for the failure. 

User Action: Verify that the correct file is being accessed and can be 
read. 

ERROPELOG, at tag or text, line n, file 
file-spec 

Cannot open log file: 
filename 

Warning: The <SET> built-in tag has failed to open a file for trace output. 
The next Informational message may indicate the reason for the failure. 
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User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

ERROPEOUT, at tag or text, line n, file 
file-spec 

Cannot open output file: 
filename 

Fatal: The tag translator cannot open the output file. The next 
Informational message may indicate the reason for the failure. 

User Action: Verify that the file specification is correct and that you have 
sufficient resources and access rights to create the file. 

ERROPESEC, at tag or text, line n, file 
file-spec 

Cannot open secondary output file: 
filename 

Warning: An attempt to open a secondary output file failed. Processing 
continues, but output will go to the primary output file. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

ERROPESIN, at tag or text, line n, file 
file-spec 

Cannot open cross reference input file: 
filename 

Fatal: The tag translator failed to open the file that contains the symbols 
used for cross-references. The next information message indicates the 
reason for the failure. 

User Action: The file that contains the symbols used in cross-referencing 
can be used by only one user at a time. The tag translator locks the file to 
ensure that users have only serial access to it. If the reason for the failure 
to open the file was due to the fact that another user was currently using 
the file, you must wait and reissue the command when the file is no longer 
in use. 

ERROPESOT, at tag or text, line n, file 
file-spec 

Cannot open cross reference output file: 
filename 

Fatal: The tag translator failed to open a file for writing the symbols used 
for cross references. The next Informational message may indicate the 
reason for the failure. 

User Action: Verify that you have sufficient resources and access rights 
to create the file. 
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ERRPRSFSP, at tag or text, line n, file 
file-spec 

Error parsing file specification: 
filename 

Warning: The file specification contains an error. 

User Action: Correct the file specification or logical name definition. 

ERRVMZONE, at tag or text, line n, file 
file-spec 

Internal error. Failure to create VM zone. 

Fatal: The tag translator failed to create space in virtual memory for 
storage of data. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

EXAMINLIN, Examine line number of file filename 

Informational: This message follows other messages of greater severity, 
and directs you to a possible error in the input. 

User Action: Use the information to examine and correct your input. 

EXFOOTNOT, at tag or text, line n, file 
file-spec 

Footnotes in a monospaced example exceeds maximum of 4. 

Warning: You have specified more than four <FOOTNOTE> tags in a <CODE_ 
EXAMPLE> or other monospaced example. The maximum allowed is four. 
The footnote will not be processed. 

User Action: Correct the source file by removing the extraneous 
footnotes. 

EXPAPPLET, Explicit appendix letter string set on line number of file 
filename 

Informational: Warns that the letter assigned to the next <APPENDIX> 
tag has been supplied explicitly by a <SET_APPENDIX_LETTER> tag. The 
appendixes may be lettered out of sequence. 

User Action: None. 

EXPAPPNUM, Explicit appendix number number set on line number of file 
filename 

Informational: Warns that the number assigned to the next <APPENDIX> 
tag has been supplied explicitly by a <SET_APPENDIX_NUMBER> tag. The 
appendices may be numbered out of sequence. 

User Action: None. 
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EXPCHAPNO, Explicit chapter number number set on line number of file 
filename 

Informational: Warns that the number assigned to the next <CHAPTER> 
tag has been supplied explicitly by a <SET_CHAPTER_NUMBER> tag. The 
chapters may be numbered out of sequence. 

User Action: None. 

FILEWRTNG, File filename written (0 length) 

Informational: An Error or Fatal message has been issued during the 
tag translation of a book element. The output file for that book element is 
reduced to 0 length. 

User Action: Correct the problems indicated in the Error and Fatal 
messages and reprocess. 

FILEWRTOK, File filename written 

Informational: An element of a book has been processed through the tag 
translation phase. 

User Action: None. 

FCMDPARMS, at tag or text, line n, file 
file-spec 

<tagname> specified without <tagname> in Format. 

Using <tagname> alone 

Warning: The tags <FCMD> and <FPARMS> must be used together to 
produce predictable results. 

User Action: Modify your source file so that it contains both the <FCMD> 
and <FPARMS> tags. Arguments to either of these tags may be null, that is, 
it is valid to specify <FCMD>. 

FIGINDENT, at tag or text, line n, file 
file-spec 

The value number specified for a block indent exceeds the 
current allowed maximum of number. 

Warning: A <FIGURE_FILE> tag specified the INDENT argument and a 
value that exceeds the current maximum allowed. The maximum value 
will be used. 

User Action: Correct the numeric argument specified with INDENT so 
that it does not exceed the indicated maximum. 

FIGLINMAX, at tag or text, line n, file 
file-spec 

Monospaced example lines in <tagname> exceed maximum 
number. 

Error: A monospaced example specified in the context of a <FIGURE> or 
<EXAMPLE> tags is too long to fit on the current page, and either no 
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<VALID_BREAK> tags were specified to provide valid break points, or there 
are too many lines between <VALID_BREAK> tags. 

User Action: Put <VALID_BREAK> tags at suitable places in the 
monospaced example to allow the pages to break automatically. 

FIG_DEPTH, at tag or text, line n, file 
file-spec 

Tag <tagname> value number exceeds the maximum NUMBER 
or is 0. 

Warning; The indicated tag specifies a depth for a figure or space to be 
left for a figure that will overrun the page boundaries. Or, the argument 
was specified as 0. In either case, the document’s default full page depth 
will be used. 

User Action: Correct the tag so that you specify no more than the 
maximum allowed. 

FIG_WIDTH, at tag or text, line n, file 
file-spec 

Tag <tagname> value number exceeds the maximum NUMBER 
or is 0. 

Warning: The indicated tag specifies a width for a figure or space to be 
left for a figure that will overrun the page boundaries. Or, the argument 
was specified as 0. In either case, the document’s default full page width 
will be used. 

User Action: Correct the tag so that you specify no more than the 
maximum allowed. 

FILENUMNG, at tag or text, line n, file 
file-spec 

File number is out of range 

Warning: A number supplied to the <FILE_NAME> tag is not within the 
range of 1 to the number of files that have been opened. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

FILISOPEN, at tag or text, line n, file 
file-spec 
Auxiliary file: 
filename 
is already open 

Warning; An <OPEN> built-in tag is specifying a file that is already open. 
The request is ignored and processing continues. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 
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FILNOTOPN, at tag or text, line n, file 
file-spec 
Auxiliary file: 
filename 
is not open 

Warning: A <READ> or <WRITE> built-in tag is addressing a file that has 
not been opened. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

FMTDEVICE, Tag <tagname> produces device-specific output. 

Informational: A tag that produces specific formatting controls has 
been processed. The output may not be suitable if the file is processed 
for another doctype, destination, or both. For example, <FINAL_ 
CLEANUP>(LINE_BREAK) tells the text processor to create a new line of 
output, but the line break may not be suitable on all output devices. 

User Action: Use explicit formatting commands sparingly. 

GTMAXARGS, at tag or text, line n, file 
file-spec 

More than number arguments supplied to tag <tagname> 

Error: The indicated tag does not expect more than the indicated number 
of arguments. You may have included a backslash character in one of the 
arguments, which the tag translator interpreted as an argument separator. 

User Action: Verify that the argument list is correctly coded. If 
necessary, use the <BACKSLASH> tag to code a backslash character that 
is actually part of an argument. 

HIDNOTHID, at tag or text, line n, file 
file-spec 

Internal error. A hidden tag was invoked, 

but was not found in the data structure of hidden tag names 

Fatal: The algorithm for hiding and revealing tags has failed. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

ICON_TEXT, at tag or text, line n, file 
file-spec 

No text supplied for <IC0N>. 

Warning: An <IC0N> tag was specified, but no <IC0N_TEXT> tag specified 
text to accompany the graphics. No text will be output. 

User Action: Verify that you specified <IC0N_TEXT> correctly. 
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IGNAMEILL, at tag or text, line n, file 
file-spec 

Argument string to <IGN0RE> is illegal 

Warning: The argument is not a legal name or label. The argument is 
dropped from the argument list, and processing continues. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

IGNAMEMIS, at tag or text, line n, file 
file-spec 

An argument to <IGN0RE> tag is a null string 

Warning: One of the arguments to an <IGN0RE> tag is empty. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

IGNOREARG, Ignoring the argument 

Informational: This message usually accompanies other error messages 
that indicate a faulty argument. It indicates that the faulty argument is 
being ignored. 

User Action: Correct the SDML file. 

IGNORESET, Ignoring <tagname> on line number of file 
filename 

Informational: This tag is ignored when doing a book build or element 
build, because the numbering of book elements is done automatically. 

User Action: Remove the tag. 

IGNOTDONE, at tag or text, line n, file 
file-spec 

The <IGN0RE> tag has no arguments, so it is ignored 

Warning: Missing or illegal arguments have resulted in an <IGNORE> tag 
that has no legal arguments. The <IGN0RE> tag is not executed. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

INCNOTARG, at tag or text, line n, file 
file-spec 

An <INCLUDE> tag cannot be invoked in an argument 
Error: An <INCLUDE> tag can be invoked only in text. 

User Action: Move the <INCLUDE> tag outside the argument list. 
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INCOVRFLW, at tag or text, line n, file 
file-spec 

More than number nested levels of included files 

Fatal: The number of included files that can be open at the same time is 
limited. The limit has been exceeded. 

User Action: Consider whether the included files can be included 
sequentially rather than simultaneously. If file A includes file B, and 
file B includes file C, consider whether file A can include both B and C, 
one after the other. 

INDENTVAL, at tag or text, line n, file 
file-spec 

The <tagname> specifies an indent value of number. 

This exceeds the maximum number allowed for this tag. 

Warning: The INDENT argument to the specified tag specified an indent 
value that exceeds the maximum allowed. The maximum value will be 
used. 

User Action: Correct the tag to specify an indent value less than or equal 
to the maximum allowed. 

INT_LOGIC, at tag or text, line n, file 
file-spec 

Internal error processing tag <NAME> 

Error: An SDML tag definition has an error in it. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

INVINHELP, Tag <tagname> being ignored for HELP processing. 

Informational: The SDML tag used is invalid in the HELP doctype. The 
tag and its arguments are ignored. 

User Action: None. 

INVLDDEST, at tag or text, line n, file 
file-spec 

Destination string is invalid with the string doctype. 

Fatal: The destination is invalid with the doctype used. 

User Action: Check to see that the doctype and destination you are using 
are compatible. 

ISTHISTAG, at tag or text, line n, file 
file-spec 

Ignoring <string terminated by char. 

Is this a tag without a closing angle bracket? 

Warning: An apparent tag name has been found, but without the closing 
angle bracket that is needed to make it a complete tag invocation. 
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User Action: If this is a typing error, simply add the closing angle 
bracket. If this is not a typing error (you really want the left angle bracket 
and the tag name to appear in the output), use the <LITERAL> tag to 
enclose the left angle bracket. 

KEYPADROW, at tag or text, line n, file 
file-spec 

Too many keypad rows. Extra rows ignored 

Warning: A set of tags within a <KEYPAD_SECTlON> specifies more than 
four <KEYPAD_ROW> tags. The keyboard keypad has only four rows and one 
end row. 

User Action: Determine which <KEYPAD_ROW> tag is extra and remove it 
from your source file. 

LASTAGWAS, Last occurrence of <tagname> was on line number 

Informational: This message is issued when a tag is not ended before a 
particular context or the end-of-file. It tells you the line number of the last 
occurrence of the tag. 

User Action: Use the indicated line number to determine where to correct 
your source file. 

LISTYPWAS, List type was string 

Informational: This message accompanies an error that indicates that a 
<LIST> tag was not terminated. It indicates the type of list, for example, 
NUMBERED, UNNUMBERED, and so on. 

User Action: Use this information to correct your SDML source file. 

LITOVRFLW, More than number characters in literal. See line number of file 
filespec 

Fatal: The size of the text encompassed by a <LITERAL> or <DELAYED> tag 
is limited. This error may indicate that a <LITERAL> or <DELAYED> tag was 
incorrectly terminated. 

User Action: Verify that the <LITERAL> or <DELAYED> tag has been 
correctly coded. If the text to be encompassed by the tag exceeds the limit, 
you must break it up and use more than one <LITERAL> or <DELAYED> tag. 

LMF_NOLMF, at tag or text, line n, file 
file-spec 

No LMF information is specified for this document 
Warning: LMF information is missing. 

User Action: Check to ensure that the LMF information exists if it is 
required for your document. Sometimes, incorrect use of the <REFERENCE> 
tag within the argument to the <TITLE> tag causes this problem. 
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LMFINFAFT, at tag or text, line n, file 
file-spec 

Make sure <tagname> is specified after the LMF tags. 

No LMF information is written out. 

Warning: The <LMF_INF0> tag may be specified before the LMF tags. 

User Action; You may want to check to ensure that the LMF tags are 
coded before the <LMF_INF0> tag. 

LMFNOALTN, at tag or text, line n, file 
file-spec 

Tag <tagname> may be missing 
Warning; An <LMF_ALTNAME> tag may be missing. 

User Action; Although this tag is not required, you may want to check to 
ensure that, if it exists, it is not miscoded. 

LMFNOINFO, at tag or text, line n, file 
file-spec 

Missing <LMF_INFO> tag. 

Warning; The <LMF_INF0> tag is missing. 

User Action; Check to ensure that the LMF information exists if it is 
required for your document. 

LMFTAGMSG, at tag or text, line n, file 
file-spec 

Tag <tagname> is missing 
Error: An LMF tag is missing. 

User Action: Check to ensure that the <LMF_PRODUCER>, <LMF_PRODUCT>, 
<LMF_RELEASE_DATE>, and <LMF_VERSION_NUMBER> tags exist. 

LMF_TOMNY, at tag or text, line n, file 
file-spec 

LMF information is specified more than once for this document 

Error; LMF information is specified more than once for this document. 

User Action: You can specify LMF information only once for each 
document. Check for too many <LMF> tags. 

LTMINARGS, at tag or text, line /i, file 
file-spec 

Fewer than number arguments supplied to tag <tagname> 

Error; The indicated tag requires a minimum number of arguments. 
Perhaps one of the arguments has an unmatched right parenthesis in it, 
and the tag translator has treated that character as the terminator of the 
argument list. 

User Action: Review and correct the argument list. Be sure that the 
open parenthesis for the argument list is not preceded with a space; for 
example <TAG> (ARG) should be <TAG>(ARG). 
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MAKKUNBAL, at tag or text, line n, file 
file-spec 

<MARK> tags are unbalanced. 

Error: A <MARK> tag and its corresponding <ENDMARK> tag cross a tag’s 
boundary or are incorrectly nested with respect to another pair of tags. 
For example, if a <maek> tag is specified before <FOKMAT> and <ENDMARK> 
is specified before <ENDFORMAT>, the tags are considered unbalanced. 

User Action: Find the source file location of the indicated tag and move 
it. In particular look for instances where a <MARK> tag is specified in a tag 
argument, but the <ENDMARK> tag is specified outside that tag’s argument 
or in an argument to another tag. 

MILNOCLSS, No security classification has been specified 

Informational: The <HIGHEST_SECURITY_CLASS> tag has been specified to 
output the highest security classification. However, no <SECURITY> tags 
have been specified in the document to provide a classification and so no 
output will be produced. 

User Action: Add a <SECURITY> tag to indicate the document’s security 
classification or remove the <HIGHEST_SECURITY_CLASS> tag. 

MINEXCMAX, at tag or text, line n, file 
file-spec 

Minimum argument count {number) exceeds maximum 
argument count {number). 

(Minimum argument count is being reset to zero) 

Warning: A <DEFINE> or <REDEFINE> tag is specif 5 dng a minimum and 
maximum number of arguments and the minimum exceeds the maximum. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

MSGIDISNG, at tag or text, line n, file 
file-spec 

The message identification string is invalid. 

The <HIDE_TAGS> tag is ignored 

Warning: The second argument to a <hide_tags> tag is supplying an 
unknown message identification. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

NAME2LONG, at tag or text, line n, file 
file-spec 

Condition name string exceeds 28 characters 

Error: Condition names may not exceed 28 characters in length. 

User Action: Shorten this name (and any other condition names that are 
too long) to 28 characters or less. 
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NAMETRUNC, at tag or text, line n, file 
file-spec 

Name string exceeds 31 characters. 

Name string is truncated version 

Warning; Names may not exceed 31 characters in length. The name 
that was supplied is a legal name, but it is too long. It is truncated to 31 
characters. 

If more than one name is truncated, the shortened names may not be 
unique and other errors may occur depending on the type of name. 

User Action: Shorten this name (and any other names that are too long) 
to 31 characters or less, so that there is no potential for other errors. 

NESTEDCOM, A <COMMENT> tag on line number of file 
filename 

is nested within <COMMENT> . . . <ENDCOMMENT> that starts 

on line number of file 

filename 

Warning: <COMMENT> tags cannot be nested. 

Sometimes an error is made in typing a <COMMENT> tag in the format 
<COMMENT>(text). The typing erro makes it appear that the tag does 
not have an argument list, and it is assumed that an <ENDCOMMENT> 
tag is present to end the comment text. During the search for the 
<ENDCOMMENT> tag, if another <COMMENT> tag is encountered it will 
appear to be nested within the first <COMMENT> tag’s text. 

User Action: Correct any typographical errors in the initial <COMMENT> 
tag or remove the nested <COMMENT> tag. 

NOBCKNOTE, at tag or text, line n, file 
file-spec 

Accumulated back notes not referenced. 

Notes will not be output 

Warning: A document contained <BACK_NOTE> tags, but no corresponding 
<BACK_NOTES> tag was specified to output the accumulated notes. 

User Action: Place the <BACK_NOTES> tag in the source file at the position 
at which you want them output. 

NOBIBNOTE, at tag or text, line n, file 
file-spec 

Accumulated bibliographic notes not referenced. 

Notes will not be output 

Warning: A document contained <BlB_NOTE> tags, but no corresponding 
<BIB_N0TES> tag was specified to output the accumulated notes. 

User Action: Place the <BIB_N0TES> tag in the source file at the position 
at which you want them output. 
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NOCONFILE, at tag or text, line n, file 
file-spec 

<C0NTENTS_FILE> tag specified without /CONTENTS qualifier. 
No new file wdll be generated. 

Warning: A <CONTBNTS_FlLE> tag was encountered in the input file, 
but the corresponding /CONTENTS qualifier was not present on the 
command line. No new contents file will be produced. An earlier version 
of a contents file, if it exists, may be included in the output. 

User Action: If you want to include a current table of contents file, 
you should reissue the DOCUMENT command using the /CONTENTS 
qualifier. 

NODEFITEM, at tag or text, line n, file 
file-spec 

Definition list specified no items before <tagname>. 

Warning: A <DEFINITI0N_LIST> tag, or a corresponding tag in the 
SOFTWARE doctype, was specified but no <DEFLIST_ITEM>/<DEFLIST_DEF> 
tags were specified for the list. No output wdll be produced. 

User Action: Remove the definition list start/end tags or provide item 
text for the definition list. 

NOENDPROF, at tag or text, line n, file 
file-spec 

The <PR0FILE> tag was not terminated by an <ENDPR0FILE> tag 

Warning: In order for the book build process to be completed, the 
<PR0FILE> tag must be terminated by an <ENDPR0FILE> tag. The 
<ENDPR0FILE> tag is supplied by default in this case. 

User Action: If the <PR0FILE> tag is not terminated by an <ENDPROFIIjE> 
tag, add one after the final <ELEMENT> or <INCLUDES_FILE> tag. 

NOFIGELMS, at tag or text, line n, file 
file-spec 

<tagname> has no elements. 

Warning: A <FIGURE> or <EXAMPLE> tag was specified and terminated 
but there were no elements (for example, <FIGURE_SPACE>) to place in the 
figure. 

User Action: Verify that you correctly spelled and entered tags for the 
figure or example. 

NOHIDERVL, at tag or text, line n, file 
file-spec 

Ignoring request to hide the <REVEAL_TAGS> tag 

Warning: The <REVEAL_TAGS> built-in tag cannot be hidden by the action 
of a <HIDE_TAGS> built-in tag. 

User Action: If you receive this message and are under a service contract 
wdth Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 
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NOINXFILE, at tag or text, line n, file 
file-spec 

<INDEX_FILE> tag specified without /INDEX qualifier. No new 
file will be generated. 

Warning: An <INDEX_FILE> tag was encountered in the input file, but the 
corresponding /INDEX qualifier was not present on the command line. No 
new index file will be produced. An earlier version of an index file, if it 
exists, may be included in the output. 

User Action: If you want to include a current index file, you should 
reissue the DOCUMENT command using the /INDEX qualifier. 

NONESTING, at tag or text, line n, file 
file-spec 

Invalid attempt to nest tag <tagname>. Ignored 

Warning: A tag is referenced when its context is already active. For 
example, this message is issued when <CODE_EXAMPLE> is specified when a 
previous <CODE_EXAMPLE> is not terminated. 

User Action: The indicated tag is ignored; however, you should verify 
your source file to determine whether the tag is a duplicate or whether, in 
fact, you did not terminate an earlier occurrence of the same tag. 

NONEWFILE, at tag or text, line n, file 
file-spec 

<tagname> specified without string. No new file will be 
generated. 

Warning: A <CONTENTS_file> or <INDEX_FILE> was encountered in the 
input file, but the corresponding /CONTENTS or /INDEX qualifier was not 
present on the command line. No new contents or index will be produced. 
An earlier version of a contents or index file, if it exists, may be included 
in the output. 

User Action: If you want to include the current table of contents or index 
file, you should reissue the DOCUMENT command using the appropriate 
qualifier. 

NOPROFILE, at tag or text, line n, file 
file-spec 

Tag can appear only following a <PR0FILE> tag 

Fatal: The tag is part of a profile and can be used only in that context 
and only within the same file as the <PROFILE> tag. 

User Action: Check that the tag appears after a <PR0FILE> tag and in the 
same file as the <PR0FILE> tag. 
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NOREADOUT, at tag or text, line n, file 
file-spec 

Cannot read from file; 
filename 

The file is opened as output 

Warning: A <READ> built-in tag cannot be addressed to an auxiliary file 
that is opened as output. (The <OPEN> tag defaults to output mode unless 
INPUT is specified.) 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

NOREFNOTE, at tag or text, line n, file 
file-spec 

Accumulated reference notes not referenced. 

Notes will not be output 

Warning: A document contained <REF_NOTE> tags, but no corresponding 
<REF_NOTES> tag was specified to output the accumulated notes. 

User Action: Place the <REF_NOTES> tag in the source file at the position 
at which you want them output. 

NOTDOCTYP, at tag or text, line n, file 
file-spec 

Tag <tagname> is not allowed in the string doctype 

Error: The indicated tag is not meaningful in the context of the doctype 
specified on the command line and cannot be processed. For example, the 
LETTER doctype does not allow <CHAPTER> or heading-level tags. 

User Action: Verify that you specify the correct doctype kejrword on the 
DOCUMENT command line. If the doctype is correct, remove the tags 
from the SDML source file. 

NOTHIDNAM, at tag or text, line n, file 
file-spec 

A <REVEAL_TAGS> tag is referencing an unknown hide-name, 
string 

Warning: The hide-name specified by a <REVEAL_TAGS> tag is not in use. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

, at tag or text, line n, file 
file-spec 

Tag can appear only within the context established by 
an element heading tag such as <CHAPTER>, <PART>, and so 
forth. 
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Error: When a book build is done, all text and the tags that accompany 
the text must appear within some element of the book. The text and tags 
must follow the element heading tag in order to be considered to be in the 
context of the element. 

User Action: Correct the source text so that the tag that is in error 
follows a tag that heads an element of the book. 

NOTINPROF, at tag or text, hne n, file 
file-spec 

The <tagname> tag must appear in the same file as the 
<PROFILE> tag 

Error: All the tags that make up a profile must appear in the same file. 
User Action: Move the tag into the same file as the <PROFILE> tag. 

NOUNDEFBI, at tag or text, line n, file 
file-spec 

Ignoring <UNDEFINE> or <REDEFINE> of the built-in definition of 
<tagname> 

Warning: A tag translator built-in tag cannot be deleted by the action of 
a <REDEFINE> or <IJNDEFINE>. The built-in tag can be “stacked” by issuing 
a <DEFINE> tag for it, however. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

NOWRITEIN, at tag or text, line n, file 
file-spec 

Cannot write to file: 
filename 

The file is opened as input 

Warning: The <WRITE> built-in tag cannot write to an auxiliary file that 
has been explicitly opened as input. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

NOZONEYET, at tag or text, line n, file 
file-spec 

Tag <tagname> specified outside its valid zone or context. 

It must be preceded by tag <tagname>. 

Error: A tag was specified outside the context that enables it, for 
example, a <COPYRlGHT_PAGE> tag was specified when the tag <FRONT_ 
MATTER> has not been specified to enable the front matter zone. 

User Action: Be sure that you have specified the correct tag. Add the 
appropriate zone-enabling tag. 
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NO_OUTPUT, No output is produced for this tag 

Informational: This message accompanies other warning messages. It 
indicates that the tag is being ignored and no output is produced. 

User Action: Correct the SDML file to remove the other warning 
messages. 

NO_PREFIX, at tag or text, line n, file 
file-spec 

No character string prefix is available. 

Warning: A tag in a template specified that a character-string prefix 
was to be used for page or formal element numbering, but no prefix was 
specified. 

User Action: Specify a prefix for the section in the <SET_TEMPLATE_ 
PREFIX> tag. 

NUMBERARG, at tag or text, line n, file 
file-spec 

Argument number is not valid for <tagname>. 

Warning: The numeric argument is not valid for the tag. 

User Action: Consult the tag’s documentation to determine the valid 
values. 

NUMLTZERO, The argument is less than 0. 

Informational: This message accompanies a message about an invalid 
numeric argument. It indicates that a negative value was specified for a 
tag argument which must be a positive number. 

User Action: Consult the documentation to determine the tag’s valid 
values. 

0_ARGNTNM, at tag or text, line n, file 
file-spec 

Argument number to tag <tagname> is not a valid name 

Error: The indicated argument does not obey the rules for formation of 
a name. A name can have only letters, munbers, and underscores and a 
name cannot begin with two underscores. You can use spaces, tabs, and 
carriage returns. 

User Action: Correct the argument so that the name is valid. 

0_DFINTAG, at tag or text, line n, file 
file-spec 

A <DEFINE> tag should be removed from this file. 

Consider using a <DEFINE_SYMBOL> tag in its place. 

Fatal: The definition of the <DEFINE> tag will not appear in the modified 
source file. 

User Action: Tag definitions should be in separate files called with the 
/SYMBOLS qualifier on the command line. 
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0_FN0TPRB, at tag or text, line n, file 
file-spec 

Possible problem with footnotes 

Warning: The software has detected a possible problem with footnotes. 
User Action: Check to ensure that all footnotes are coded correctly. 

OJGNRTAG, at tag or text, line n, file 
file-spec 

Ignoring <tagname>. 

You have specified multiple <tagname> tags with the MASTER 
argument, 

ignoring all but the first tag. 

Warning: Multiple <SET_online_topic> tags with the MASTER argument 
have been specified. 

User Action: Remove the extra <SET_0NLINE_T0PIC> tags. 

0_TAGMISN, at tag or text, line n, file 
file-spec 

Tag <tagname> is missing 

Warning: A Bookreader <ONLlNE_PAilT_NUMBER> tag is missing. 

User Action: Check to ensure that the <ONLINE_part_number> tag exists 
if it is required for your document. 

O.TMNYXTR, at tag or text, line tz, file 
file-spec 

More than 25 characters in argument to tag <tagname>. 

Fatal: There is a limit of 25 characters in the argument to the <SY1VIB0L_ 
PREFIX> tag. 

User Action: Check to ensure that the argument to the <SYIV[B0L_PREFIX> 
tag has no more than 25 characters. 

OBKSYMMSG, at tag or text, line n, file 
file-spec 

Book does not contain a valid book S5rmbol name. 

Warning: The book is missing a valid book symbol name. 

User Action: Check to ensure that the <ONLlNE_lNFO_SYiVlBOL> tag exists 
if it is required for your document. 

OCONTOMNY, at tag or text, line n, file 
file-spec 

Too many <tagname> tags. 

Fatal: Too many <C0NTENTS_FILE> tags have been defined for this 
document. 

User Action: Bookreader documents are limited to one <CONTENTS_FILE> 
tag. Check for too many <C0NTENTS_FILE> tags. 
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OENONSTNG, at tag or text, line n, file 
file-spec 

Invalid attempt to nest tag <tagname>. 

Error: A tag is referenced when its context is already active. For 
example, this message is issued when an <ONLlNE_POPUP> tag exists 
after a previous <ONLlNE_POPUP> tag that you did not terminate. 

User Action: The indicated tag is ignored; however, you should verify 
your source file to determine whether the tag is a duplicate or whether, in 
fact, you did not terminate an earlier occurrence of the same tag. 

OESYMISNG, at tag or text, line n, file 
file-spec 

Missing symbol argument to a <tagname> tag. 

Symbol names are required when referencing headings, 
formal tables, examples, and figures. 

Error: Sjrmbols are required when referencing headings, formal tables, 
examples, and figures in Bookreader doctypes. 

User Action: Supply a symbol name as an argument to the tag. You may 
want to use the /GENEEATE_SYMBOL qualifier to automatically generate 
missing symbols. 

OFILNOTCV, at tag or text, line n, file 
file-spec 

Cannot open new version of: 
filename 

File not converted. 

Warning: An attempt to open an included file failed. 

User Action: Verify that the file specification is correct, and that you 
have sufficient resources and access rights to create the file, 

OFNONSTFM, at tag or text, line n, file 
file-spec 

Invalid attempt to place tag <tagname> within <0NLINE_ 
POPUP>/<ENDONLINE_POPUP> tags. 

Fatal: <HEADn> tags, formal examples, figures^ and tables are not allowed 
between <online_popup>/<Endonline_popup> tags. 

User Action: Either remove the <ONLINE_POPUP>/<ENDONLINE_POPUP> 
tags or use an informal example, figure, or table. Also, be sure no <HEADn> 
tags are in the popup. 

OFNONSTNG, at tag or text, line n, file 
file-spec 

Invalid attempt to nest tag <tagname>. 

Fatal: A tag is referenced when its context is already active. For example, 
this message is issued when an <ONLlNE_POPUP> tag exists after a previous 
<ONLlNE_POPUP> tag that you did not terminate. 
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User Action: The indicated tag is ignored; however, you should verify 
your source file to determine whether the tag is a duplicate or whether, in 
fact, you did not terminate an earlier occurrence of the same tag. 

OFONLCHNK, at tag or text, line n, file 
file-spec 

Invalid attempt to place tag <tagname> in a formal example, 
figure, or table. 

Fatal: <0NLINE_CHUNK> tags are not allowed in formal examples, figures, 
or tables. 

User Action: Remove the <0NLINE_CHUNK> tag or use an informal 
example, figure, or table. 

OHIVERNUM, at tag or text, line n, file 
file-spec 

Version number detected on included file, string. 

Higher version of that file is being written. 

Warning: The tag translator has detected a version number on an 
included file. A file with a higher version number is being written. 

User Action: The source file has included a file with a specific version 
number and the symbol generator is writing a file with a higher version 
number. Either remove the version number or modify the file specification 
to the higher number. 

OINVPREFX, at tag or text, line n, file 
file-spec 

Invalid symbol argument to /PREFIX= qualifier on command 
line. 

Fatal: Invalid characters have been detected in the s 3 mbol argument to 
the /PREFIX= qualifier on the command line. 

User Action: Check to enfeure that there are no invalid characters, such 
as dollar signs ($) or hyphens (-), in the S 5 mbol argument to the /PREFIX 
qualifier on the command line. 

OSYMNTDEF, at tag or text, line n, file 
file-spec 

Symbol string is undefined 

Error: A symbol has been referenced but is not in the symbol table. 

User Action: Verify that the fymbol is spelled correctly and that the 
same symbol has been entered in the symbol table. 

OTTLPGMSG, at tag or text, line n, file 
file-spec 

Tag <TITLE_PAGE> is missing 

Error: A <TITLE_PAGE> tag is missing. Bookreader doctypes require the 
<TITLE_PAGE> tag. 

User Action: Check to ensure that the <title_PAGE> tag exists and is 
coded correctly. 
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OTL_LEVEL, at tag or text, line n, file 
file-spec 

Outline level specified, number, is not in range 
The argument must specify 1 through 6 

Warning: An invalid number was specified in a <LEVEL> tag in an outline. 
Only levels of 1 through 6 are valid. 

User Action: Correct your source file so that no outline level has a 
number greater than 6. 

OTL_TITLE, at tag or text, line n, file 
file-spec 

<tagname> not valid within outlines. 

Enter the title as an argument to the <OUTLINE> tag 

Warning: A <TITLE> tag was specified within the context of the <0UTLINE> 
tags. 

User Action: Correct your source file so that the title of the outline is 
supplied in arguments to the <OUTLINE> tag. 

OUTLIN2BG, at tag or text, line n, file 
file-spec 

Output line exceeded number bytes, and had to be broken 

Warning: Text in an output line exceeded the tag translator’s buffer. No 
text was lost because the line was written as two lines, but the division 
into two lines may have broken a word into two words, or interfered with 
the correct formatting of the text. This usually happens when the tag 
translator inserts many formatting commands into an output line. It also 
happens when a tag reference on a long input line is replaced by a very 
long string of text. 

User Action: Check the formatted output that corresponds to the input 
line specified in the location information to see if breaking the line affected 
the formatting. 

PARSECODE, at tag or text, line n, file 
file-spec 

Argument number has illegal action code char 
Error: The character shown is not one of the allowed action codes. 

User Action: Correct the indicated argument to the tag. 

PARSELNEQ, at tag or text, line n, file 
file-spec 

Lengths of delimiter and action arguments are not equal 

Error: The number of delimiter characters and the number of action 
codes in one of the action strings are not the same. 

User Action: Correct the delimiter or action arguments to the tag. 
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POSTERROR, at tag or text, line n, file 
file-spec 

Error encountered during post-translation 

Fatal: An error has been detected during the final step in tag translation. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

PQLISNONE, at tag or text, line n, file 
file-spec 

<tagname> specifies NONE when no heading is specified 

Warning: The keyword argument “NONE” was specified to a 
<PARAMDEFLIST> or <QUALDEFLIST> tag in a Context in which no default 
heading is in effect. The use of NONE in this context is meaningless. 

User Action: Determine if you intended to be using default headings for 
the <PAEAMDEFLIST> or <QUALDEFLIST> tag. If not, remove the tag from 
your source file. Otherwise, verify whether you should have invoked one of 
the reference templates to set an environment for parameter/qualifier list 
descriptions. 

PROFORDER, at tag or text, line n, file 
file-spec 

<PR0FILE> tag is out of order 

Fatal: A <PR0FILE> tag has been detected after an element heading tag, 
such as <CHAPTER> or <APPENDIX>. 

User Action: Place a single <PR0FILE> . . . <ENDPR0FILE> sequence in a 
file by itself in order to do a book build. 

PROFQ_ILL, at tag or text, line n, file 
file-spec 

/PROFILE qualifier illegal during a book build 

Fatal: The /PROFILE qualifier was supplied on the command line, 
indicating that an element build is desired, but the SDML file contains 
a <PROFILE> tag, indicating that a bookbuild is desired. The /PROFILE 
qualifier (which indicates an element build) should not be supplied when a 
bookbuild is desired. 

User Action: Invoke DOCUMENT without the /PROFILE qualifier. 

QUALVALUE, at tag or text, line n, file 
file-spec 

Value string to /CONDITION qualifier is not a valid name 

Fatal: The condition name supplied with the /CONDITION qualifier 
must contain only alphabetic and numeric characters and the underscore 
character. 

User Action: Correct the spelling of the condition name. 
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Q_BAD_POS, at tag or text, line n, file 
file-spec 

Argument 2, string, is invalid for queue name 

Error: A position argument supplied with a queueing built-in tag is 
invalid. The numeric value of the position may be out of range or an 
invalid keyword may have been used. 

User Action: Correct the tag’s position argument. 

Q_NONUM_E, at tag or text, line n, file 
file-spec 

Entry in queue name is not numeric 

Error: An <ENQUE> tag has requested that a new value be inserted in 
a queue in numeric sorted order. During the insertion a non-numeric 
entry is discovered in the queue. This can happen only if the entry was 
enqueued by a method other than numeric sorted order. 

User Action: Review the <ENQUE> tags that insert entries on this queue 
and insure that all tags request a numeric sorted order. 

Q_TOOLONG, at tag or text, line n, file 
file-spec 

Concatenation of all name queue entries exceeds max length 

Error: A <DEQUE>(name\ALL\EETURN) tag has been encountered. The 
concatenation of all the entries on the queue creates a single string that 
exceeds the maximum string length (65,012 bytes). 

User Action: Adopt a different queueing method, breaking the queue into 
more than one queue. 

REVISINFO, Document is using revision indicators 

Informational: Indicates that the <REVISI0N> tag is being processed. Text 
that is delimited by <MAEK> and <END]V[ARK> tags will be accompanied by 
revision indicators on output. 

User Action: If you intend for revision bars to print in your text, you do 
not need to take any action. However, if you intended for text indicated 
by <MAIIK> tags to not appear in the output, you should remove the 
<REVISI0N> tag from the file. 

REVISTEXT, Revised pages will contain the text string. 

Informational: This message verifies the text specified in the second 
argument to the revision tag and reminds you that only pages specified in 
an update range will be processed and printed. 

User Action: None. 
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REVIS_UPD, Revision will contain update pages only. 

Informational: This message reminds you that you specified 
<REVISI0N>(UPDATE) and that your output file will only contain the text 
for pages specified between <UPDATE_RANGE> and <ENDIJPDATE_RANGE> 
tags. 

User Action: None. 

REV_PAGES, Update pages number through number will be output 

Informational: This message indicates the pages that will be output for 
an update. 

User Action: None. 

RMVCONDTN, Removing condition condition-name 
on line number of file filespec 

Informational: A <SET_CONDlTlON>(REMOVE) tag is being executed. 

User Action: None. 

SAVTAGACT, at tag or text, line n, file 
file-spec 

Tag <tagname> has a before or after action that is 
ignored when saving a tag table 

Warning: You are attempting to invoke a tag that has a before action or 
an after action. The before action or after action cannot be executed while 
you are saving the tag in a tag table. The before action or after action will 
be executed when the saved tag table is loaded. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

SAVTAGILL, at tag or text, line n, file 
file-spec 

This built-in tag cannot be invoked during the saving of a tag 
table 

Error: Only certain built-in tags can be stored in a saved tag table for 
invocation when the saved tag table is loaded. This tag is not one that can 
be saved. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

SAVTAGLEV, at tag or text, line n, file 
file-spec 

Tag <tagname> cannot be invoked within an argument list 
during saving of a tag table 

Error: During the saving of a tag table, the arguments to all tags must 
be constant or must be made constant by quoting them. 
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User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

SDML_INFO, message 

Informational: An SDML tag is describing action taken during tag 
loading. 

User Action: None. 

SECFILOPN, at tag or text, line n, file 
file-spec 

Cannot open a secondary output file named 
filename 

A secondary output file is already open. It is named 
filename 

Error: Only one secondary output file can be open at a time. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

SETCONDTN, Setting condition condition-name 
on line number of file filespec 

Informational: A <SET_C0NDITI0N> tag is being executed or a condition is 
being set in response to a /CONDITION qualifier on the command line. 

User Action: None. 

SKIPITEMS, at tag or text, line n, file 
file-spec 

number <tagname> outside of <tagname> skipped. 

Warning: This message is usually preceded by a message indicating that 
an <LE> or <table_row> tag was encountered. It indicates the number of 
additional tags that were specified. The tags will not be processed, and 
will be written, unformatted, to the output file. 

User Action: Determine if the tags are considered invalid because there 
is no preceding <TABLE> or <LIST> tag, or if the <TABLE> or <LIST> tag was 
specified incorrectly. Correct your source file. 

STKOVRFLW, at tag or text, line n, file 
file-spec 

More than number nested levels of tags. (These are 
tags that are invoked inside other tags’ argument lists) 

Fatal: The tag translator limits the number of tags that can be invoked 
simultaneously. Tag B is invoked simultaneously with tag A, if it is 
invoked in the argument list to tag A. Thus, <A>(<B>(<C>)) requires that 
three tags are being invoked simultaneously. This may occur unexpectedly 
when the argument list to one of the tags is not properly terminated. 

User Action: Verify that the argument list of the tag that is specified in 
the location information has been properly terminated. 
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STRFREE2T, at tag or text, line n, file 
file-spec 

Internal error. Attempt to free the same string twice 

Fatal: The tag translator’s memory allocation algorithm has failed. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

STRFREEBA, at tag or text, line n, file 
file-spec 

Internal error. Attempt to free string with bad address 

Fatal: The tag translator’s memory allocation algorithm has failed. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

STRTOOBIG, at tag or text, line n, file 
file-spec 

Internal error. Attempting to allocate number-hyie string 

Fatal: The tag translator’s memory allocation algorithm has failed. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

SYMFREEBA, at tag or text, line n, file 
file-spec 

Internal error. Attempt to fi'ee symbol table entry with bad 
address 

Fatal: The tag translator’s memory allocation algorithm has failed. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

SYMISSING, at tag or text, line n, file 
file-spec 

Missing symbol argument. 

Each book element must have a symbol argument 

Fatal: Each element of a book must have a unique symbol so that the 
element can be processed independently. The symbol table cannot be 
saved from this nm. 

User Action: Supply a symbol as an argument to the tag. 
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SYMISUSED, at tag or text, line n, file 
file-spec 

The symbol string is already in use as a symbol of type string 

Error: Each element of a book must have a unique symbol. You have 
supplied a s5nnbol on this element of the book that conflicts with an earlier 
use of this symbol. The symbol table cannot be saved from this run. 

User Action: Correct the use of symbols on elements of the book so that 
each element has a unique symbol. If you are doing a book build you must 
repeat the book build in order to produce a good symbol table. If you are 
doing an element build, just correct the symbol in this tag so that this 
element of the book has a unique symbol, and then repeat the element 
build. 

SYMNOTDEF, at tag or text, line n, file 
file-spec 

Symbol string is undefined 

Warning: A symbol has been referenced but is not in the symbol table. 

User Action: Verify that the symbol is spelled correctly and that the 
same symbol has been entered in the symbol table by the invocation of a 
tag that defines the symbol. 

TAGFREEBA, at tag or text, line n, file 
file-spec 

Internal error. Attempt to free tag table entry with bad address 

Fatal: The tag translator’s memory allocation algorithm has failed. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

TAGINFILE, The tag was in the file filename 

Informational: This message may accompany a message indicating that 
a tag that must be ended was not terminated. This message is output 
when the starting tag is not in the current input file. 

User Action: Use the file spec given to determine which file contains the 
tag that was not properly terminated and terminate it. 

TAGINVALD, at tag or text, line n, file 
file-spec 

Tag <tagname> is invalid in this context. 

The context was established by <tagname> on line number of 
filename 

Error: A tag was specified in a context where it is not valid, for example, 
a header-level tag was specified within the context of a monospaced 
example. The message tells you what tag established the context. 

User Action: Determine the current context at the point at which 
the message was issued to determine if you have forgotten a required 
terminator and correct your source file. 
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TAGINZONE, at tag or text, line n, file 
file-spec 

Tag <tagname> is invalid in the bounds of string. 

Error: A tag was specified in a context where it is not valid, for example, 
a header-level tag was specified within the context of a monospaced 
example. 

User Action: Determine the current context at the point at which 
the message was issued to determine if you have forgotten a required 
terminator and correct your source file. 

TAGNOTDEF, at tag or text, line n, file 
file-spec 

Tag <tagname> is undefined 

Warning: A tag has been invoked, but no definition exists for the tag. 
This message appears for the first invocation of an undefined tag. 
Subsequent invocations of the same undefined tag are counted, but the 
message is not repeated. A count of the total number of all invocations of 
undefined tags is reported at the end of the tag translator’s processing. 

User Action: Correct the spelling of the tag or supply a definition for the 
tag. 

TAGNOTEND, at tag or text, line n, file 
file-spec 

Tag <tagname> from line number not terminated 

Error: A tag that has a required terminator was not terminated. 

User Action: Locate the tag that was not terminated and include its 
terminating tag at the appropriate position in your source file. 

TAGNOTHID, at tag or text, line n, file 
file-spec 

Cannot reveal tag <tagname>. It is not hidden 

Warning: A <REVEAL_TAGS> tag is requesting that a hidden tag be 
revealed, but the tag is not currently hidden. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

TAGNOTPRE, at tag or text, line n^ file 
file-spec 

Tag <tagname> invalid unless preceded by string 

Warning: A tag is being invoked that is invalid because it is being used 
out of context. 

User Action: Check the sequence of tags to ensure that the proper 
context is established before the tag is used. Correct the SDML source file. 
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TAGNOTPEX, at tag or text, line file 
file-spec 

Tag <tagname> invalid unless preceded by an example tag 

Warning: A tag is being invoked that is invalid because it is not being 
used within an example. 

User Action: Check the sequence of tags to ensure that an example tag is 
used before the <VALID_BREAK> tag. Correct the SDML source file. 

TAG_FAILS, The tag translator has detected a fatal error 

Error: The tag translator is terminating execution with failure status. 
The accompanying error message supplies details of the error. 

User Action: See the description of the accompanying error message. 
TAGJDENT, message 

Informational: This message will appear only in patched or baselevel 
systems. The tag translator inserts the text, which is usually some kind of 
internal baselevel indicator. 

User Action: None. 

TAG_INARG, at tag or text, line n, file 
file-spec 

<tagname> is invalid in an argument to <tagname>. 

Fatal: The indicated tag was specified in an argument to a tag that does 
not allow it. For example, a header level tag was specified in an argument 
to <TABLE_ROW>. 

User Action: Verify that you correctly terminated the argument list for 
the tag in which this tag was specified. 

TBLATTIGN, at tag or text, line n, file 
file-spec 

<TABLE_ATTRIBUTES> specified following <TABLE_SETUP> ignored. 

Warning: The <TABLE_ATTRIBUTES> tag must be specified preceding the 
<TABLE_SETUP> tag. The specified attributes will be ignored. 

User Action: Move the <TABLE_ATTRIBUTES> tag in front of the <TABLE_ 
SETUP> tag. 

TBLATTRIB, at tag or text, line n, file 
file-spec 

Argument string to tag <tagname> is not a valid table attribute 

Warning: A keyword was specified in a <TABLE_ATTRIBUTES> tag that is 
not a valid keyword attribute for tables. 

User Action: Verify that the specified value is a valid table attribute and 
check its spelling. Correct the SDML source file. 
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TBLBRKCOL, at tag or text, line n, file 
file-spec 

Table cannot be broken in column number 

Warning: The <valid_table_R0W_bREAk:> tag is valid only in columns two 
through four of a table. 

User Action: Remove the <VALlD_TABLE_ROW_BREAK> tag. If the text in 
column is too long for a page, consider restructuring the table to be less 
complex. 

TBLCOLCNT, at tag or text, line n, file 
file-spec 

Tag <TABLE_SETUP> argument 1 string is missing or is not a 
number in the range 2 through 9 

Error: The <table_SETUP> tag must specify a numeric value in the range 
of 2 through 9 to specify the number of columns in the table. The indicated 
argument is invalid. 

User Action: Correct the <TABLE_SETUP> tag. 

TBLCOLNUM, at tag or text, line n, file 
file-spec 

Table column size argument string is missing or is not numeric 

Error: An argument specified as a width for table rows in setting up the 
table is not a numeric argument. 

User Action: Correct the <TABLE_SETUP> tag that specifies a non-numeric 
value for a table column width. 

TBLCOLWID, at tag or text, line n, file 
file-spec 

Sum of table column widths number is too large or is 0 or less. 

Error: The sum of the values specified for the column widths in the 
<TABLE_SETUP> tag is excessive or is less than or equal to 0. The message 
displays the current summed value of all column widths specified. 

User Action: Verify that the numbers you specified in <TABLE_SETUP> 
are accurate. Adjust them to smaller numbers so that the table will 
fit. If you did not specify <TABLE_ATTRIBUTES>(WIDE) and the doctype 
you are using provides an extra margin for wide tables, specify <TABLE_ 
ATTRIBUTES>(WIDE) in front of the <TABLE_SETUP> tag. To request that the 
table appear in a smaller typesize, use <table_attributes>(MAXIMUM). 

TBLDUPSET, at tag or text, line n, file 
file-spec 

Tag <TABLE_SETUP> specified twice. Duplicate setup ignored. 

Warning: A table contains two <TABLE_SETUP> tags. The second tag is 
being ignored. 

User Action: Determine which <TABLE_SETUP> tag is correct and remove 
the extra one. 
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TBLFNOTEM, at tag or text, line n, file 
file-spec 

Table footnote number number exceeds maximum number 

Warning: A numeric argument specified for a footnote declaration in a 
table exceeds the maximum. The maximum number of table footnotes 
is normally 12; however, if you use any non-numeric keywords in table 
footnotes, the maximum number allowed is reduced to 6. 

User Action: Verify the number of footnotes in the table and the numeric 
arguments you use to declare and reference them. 

TBLKEYDUP, at tag or text, line n, file 
file-spec 

Table already specifies <TABLE_KEY>. Duplicate ignored. 

Warning: Only one key can be specified in a table. The second key 
specified is being ignored. 

User Action: Determine which table key is the one that you want and 
remove the extra one. 

TBLKEYNES, at tag or text, line n, file 
file-spec 

<tagname> is not valid in a nested table. 

Nested table on line number in file string. 

Warning: A <TABLE_KEY> or <TABLE_KEYREF> tag was specified in a nested 
table, that is, in a table that is specified in another table’s <TABLE_ROW>. 
Table keys and table key references are invalid in nested tables. 

User Action: Place the table key and/or the reference to it in the outer 
table. 

TBLKEYNUM, at tag or text, line n, file 
file-spec 

The <TABLE_KEY> tag will replace table footnote 12. 

Warning: When a key is specified in a table, you cannot specify a table 
footnote numbered 12. The text of the table key will replace the footnote 
number 12, and references to footnote 12 will be result in the table key 
being printed. 

User Action: Check the arguments you specified to the <FOOTNOTE> tags 
in the table and do not specify a number greater than 11. 

TBLKNOREF, at tag or text, line n, file 
file-spec 

Tag <TABLE_KEYREF> tag encountered in a table that has no 
key. 

Warning: A <table_KEYREF> tag is not valid because there is no key in 
the table to reference. 

User Action: Verify that the <TABLE_KEY> tag is correctly specified in the 
main table (it must not be specified in a nested table). If the table has no 
key, remove the <TABLE_KEY> tag. 
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TBLNBREAK, at tag or text, line n, file 
file-spec 

A nested table with more than three columns cannot be broken. 

Error: The <NESTED_TABLE_BREAK> was specified in a nested table that 
has more than three columns. 

User Action: Verify that the <TABLE_SETUP> tag for the table you are 
trying to break was correctly specified. If the nested table has four 
columns, you may need to restructure your information. 

TBLNONEST, at tag or text, line n, file 
file-spec 

Invalid table nesting. Ignored 

Warning: You coded a nested table incorrectly. There are three possible 
problems: 

1 You specified a <TABLE> tag with a caption argument in an argument 
to a <TABLE_ROW> tag. You cannot place a formal table inside another 
formal table. 

2 You specified a <TABLE> tag inside another table, but outside of a 
<TABLE_ROW> tag. All text (including nested tables) that occur within a 
table must be coded within <TABLE_ROW> tags. 

3 You specified a <TABLE_UNIT> tag inside a table that is nested in 
another table. <TABLE_UNIT> tags are not valid in nested tables. 

User Action: Based on the above situations, you should: 

1 Remove the caption argument from the nested table tag. 

2 Nest the table inside a <TABLE_ROW> tag. 

3 Remove the <TABLE_UNIT> tags. 

TBLNOROWS, at tag or text, line n, file 
file-spec 

A table was specified without any table rows. 

Error: <TABLE> and <ENDTABLE> tags were encountered in the file, but 
there were no <TABLE_ROW> tags between them. 

User Action: Verify that you specified <TABLE_ROW> tags correctly. Or, 
remove the <TABLE> and <ENDTABLE> tags if you did not want to place a 
table there. 

TBLNOTDEC, at tag or text, line n, file 
file-spec 

Table footnote number is referenced but not declared. 

Warning: A <FOOTREF> tag is specified in a table, but there is no 
corresponding <FOOTNOTE> tag at the beginning of the table. The footnote 
reference will not be printed. 

User Action: Verify that you specified the <FOOTNOTE> tag correctly 
at the beginning of the table. Verify that the number specified in the 
declaration matches the number in the <FOOTREF> tag. 
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TBLNOTMTP, at tag or text, line /i, file 
file-spec 

<tagTLame> invalid in table that is not multi-page 

Error: A tag, for example <TABLE_UNIT> was specified in a table that does 
not have the multipage attribute. 

User Action: Determine whether the table is a multipage table. If so, be 
sure that it is not specified with the ICEEP attribute. 

TBLNOTROW, at tag or text, line n, file 
file-spec 

Tag <tagname> specified outside of <TABLE_ROW>. 

Error: A tag is specified between two <TABLE_ROW> tags and is therefore 
not valid in this context. 

User Action: Correct your source file to move the tags and related text, if 
any, to within the bounds of a <TABLE_ROW> tag. 

TBLNOTSET, at tag or text, line n, file 
file-spec 

Table from line number has no <TABLE_SETUP> attributes. 

Error: A <TABLE_ROW> tag was encountered in a table without a 
<TABLE_SETUP> tag. 

User Action: Correct your source file to specify the number of columns 
and widths for the table. 

TBLNUMCOL, Table row column count does not match setup 

Informational: A tag, such as <TABLE_ROW> or <TABLE_HEADS>, specifies 
more or fewer arguments than indicated by the table setup. For example, 
a <TABLE_SETUP> tag indicates that a table has four columns, but a <TABLE_ 
ROW> tag specifies only three arguments. 

User Action: Determine whether you have not specified a column that is 
required, or whether you have correctly specified the <TABLE_SETIJP> tag. 

TBLSPANNO, at tag or text, line n, file 
file-spec 

Argument number to tag <SPAN> is invalid for the current 
column count. 

Warning: A <SPAN> tag’s argument exceeded the number of remaining 
columns in the table. For example, you specified <SPAN>(3) in a table with 
only 2 columns. 

User Action: Correct your source file to specify the number of columns 
to span. Be sure that your numeric argument, plus the current column 
number, do not exceed the number of columns in the table. 
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TEXT_FORB, at tag or text, line n, file 
file-spec 

Text forbidden after <tagname> tag 

Warning: The <tagname> tag cannot be followed by a text segment. 

User Action: Correct your source file to remove the text that follows the 
tag or tag the text correctly. 

TEXT_NEST, at tag or text, line n, file 
file-spec 

Attempt to pop a text state that has not been pushed 

Error: A <SET_TEXT_STATE>(POP) tag is being invoked when there is no text 
state saved. 

User Action: Examine the tag definitions that contain the <SET_TEXT_ 
STATE>(POP) tag for a missing <SET_TEXT_STATE>(PERMITTED\PUSH) tag. 

TEXT_REQD, at tag or text, line n, file 
file-spec 

Text missing after <tagname> tag 

Warning: The <tagname> tag marks a text segment, but the text is 
missing. 

User Action: Correct your source file to use the tag correctly. 

TMPNONEST, at tag or text, line n, file 
file-spec 

Invalid attempt to nest reference templates. 

Last template was string 

Error: A tag invoking a reference template was encountered when a 
reference template was already in effect; for example, a <R0UTINE_ 
SECTION> is specified before a previous <COMMAND_SECTION> was 
terminated. 

User Action: Correct your source file to correctly terminate the reference 
section that was not terminated. 

TMPTAGDEF, You cannot redefine <tagname> using <tagname>. 

Informational: A tag that defines a template tag specified a tag name 
that is already a defined tag. This message indicates one of the following: 

• Your input file has more than one reference template section, and you 
use the same template tag names in both. (For example, a 
<SET_TEMPLATE_ROUTlNE> tag may specify the same tag name in more 
than one occurrence of <ROUTINE_SECTION>. 

• You have specified a name that is the name of an SDML global tag. 

User Action: If the message occurred because you used the same 
template tag names in more than one reference template section, you 
need take no action. If you have used a name that is the name of an 
SDML tag, you should select another name; future use of the SDML tag 
name in the same source file may produce unpredictable results. 
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TMPTAGEND, at tag or text, line n, file 
file-spec 

<tagname> not terminated before <tagname>. 

Warning; A tag occurring within the context of a reference template 
was not terminated before the end of the file or before the beginning 
of the next reference section. For example, an <0VERVIEW> tag from a 
<COMMAND> description was not terminated before the next <COMMAND> 
description was encountered. 

User Action: Correct the source file so that you correctly terminate the 
template tag. 

TMPTAGNAM, at tag or text, line n, file 
file-spec 

string is an invalid template tag name. 

Error: A template tag, for example <SET_TEMPLATE_COMMAND>, specifies 
that the tag name that already defined in SDML, or it is an invalid name, 
that is it contains more than 31 characters, or it contains nonalphanumeric 
characters. 

User Action: Choose another name for the tag and modify your source 
file. 

UNBALPARS, at tag or text, line n, file 
file-spec 

Unbalanced parentheses in argument number 

Warning: One or more left parentheses are present without matching 
right parentheses. A sufficient number of right parentheses are appended 
to the argument to achieve a balance. 

User Action; Correct the unbalance either by adding the proper number 
of right parentheses or by coding the left parentheses using the <OPAREN> 
tag. 

UNDEFSYMS, There were number undefined S 3 mibol references 

Informational: Reports the total number of references that were made to 
undefined symbols. Only the first reference to a specific undefined symbol 
is reported. 

User Action: Either define the undefined symbol or correct the spelling 
of the symbols being referenced. The undefined symbols were reported in 
other messages. 

UNDEFTAGS, There were number undefined tag invocations 

Informational: Reports the total number of invocations of undefined 
tags. Only the first invocation of a specific undefined tag is reported. 

User Action; Either define the undefined tags or correct the spelling 
of the tag being invoked. The undefined tags were reported in other 
messages. 
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UPDATINFO, Update page label string, <tagname> 

Informational: A document that is being processed to produce update 
pages may have associated update information. The information indicated 
will be printed on the bottom of each page output. 

User Action: Verify that the update page label is correct for your 
document. 

USEDEFINC, Using a value that is one greater than previous value 

Informational: Accompanies other warning messages. It indicates that a 
default value is being used that is one greater than a previous value. 

User Action: Edit the SDML source file to correct the argument. 
USENODLIM, Using no delimiters 

Informational: Accompanies other warning messages. It indicates that a 
stacked list will be output without delimiters. 

User Action: Edit the SDML source file to correct the argument. 

USERJMSG, string 

Line is number of file filename 

Informational: This message code is used for messages written to the 
terminal or output stream when a <USER_I_MESSAGE> tag is specified in the 
input file. 

User Action: The action you take depends on the content of the user’s 
message. 

USER_WMSG, at tag or text, line n, file 
file-spec 
string 

Warning: This message code is used for messages written to the terminal 
or output stream when a <USER_W_MESSAGE> tag is specified in the input 
file. 

User Action: The action you take depends on the content of the user’s 
message. 

USESPGOUT, Alignment characters will be output as spaces 

Informational: Accompanies other warning messages. It indicates that a 
default value of space will be used as output for the alignment character. 

User Action: Edit the SDML source file to correct the argument. 

USETAGDEF, Using tag’s default: number 

Informational: Accompanies other warning messages. It generally 
indicates that a default value is being taken. 

User Action: Edit the SDML source file to correct the argument. 
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VBARINARG, at tag or text, line n, file 
file-spec 

A vertical bar was found in argument number to tag 
<tagname>. 

Use the <VBAR> tag to code a vertical bar in an argument 

Fatal: The tag translator treats the vertical bar character as a special 
operator character in arguments to tags. If you include a vertical bar 
character in an argument, the tag translator may overlook the right 
parenthesis that terminates the argument list, and may scan all of the 
remaining input looking for the proper terminator. 

If you have mistakenly omitted the closing parenthesis of an argument 
list, the tag translator begins to search the remainder of your file for a 
closing parenthesis. If it encounters a vertical bar (perhaps in a figure 
or code example), it then begins to search for a matching ampersand. 
Thus, this error message may be issued instead of the EOFAEGLST error 
message. 

User Action: Correct the argument list by replacing the vertical bar with 
the <VBAR> tag or by properly closing the argument list. 

VMOVRFLOW, at tag or text, line n, file 
file-spec 

Internal error. Failure to allocate additional space in virtual 
memory 

Fatal: This error message is generally caused by one of two types of error 
in the SDML file. These errors, and the action that you should take to 
correct them, are as follows: 

• An unterminated argument list. If you fail to terminate an argument 
list, the tag translator regards the text that follows the argument list 
as part of the last argument. Suppose you write 

<EMPHASIS>(always\BOLD> press the RETURN key. 

instead of 

<EMPHASIS>(always\BOLD) press the RETURN key. 

The tag translator does not realize that the right angle bracket should 
have been a right parenthesis. It tries to include all the following 
words as part of the second argument of the <EMPHASIS> tag. This 
means that it may store large portions of the SDML file in memory 
while it searches for a closing parenthesis to the argument list. If 
memory limits are exceeded, the VMOVRFLOW error message is 
issued. 

• Too many tag definitions. The tag translator has no limit on the 
number of tag definitions. However, a limit is imposed by the memory 
allocation algorithm. When this limit is exceeded, it usually indicates 
that one or both of the following conditions are present: 
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• A file that contains tag definitions is being repeatedly included. 
This file is often a global definitions file that is being used to 
define tags or symbols for text substitution. You can avoid memory 
limitation problems by using the <CHECK_FOR_lNCLUSION> tag at 
the start of such a file. This ensures that the file’s definitions are 
actually loaded only once, even though the file is included many 
times. 

• A tag’s definition changes frequently during execution, perhaps 
when the tag is being used to temporarily hold a text string. If the 
tag’s definition is established each time by the <DEFINE> tag rather 
than by the <redefine> tag, the definitions pile up in memory. A 
reference to the tag always retrieves the latest definition, and if 
you never use the <UNDEFINE> tag to erase the latest definition, 
you will never see the old definitions, but they are still occup 3 dng 
memory space. 

User Action: Determine if the error was caused by an unclosed argument 
list. The error is generally located by the information supplied in the error 
message. 

Otherwise, examine your tag definitions to determine whether you are 
defining the same tag name multiple times. You can avoid memory 
limitation problems by defining your tags with the <REDEFINE> tag, rather 
than with the <DEFINE> tag. Unless you specifically intend to “stack” tag 
definitions, and use the <UNDEFINE> tag to “pop” definitions off the stack, 
you should always establish a tag definition with the <REDEFINE> tag. 

XRFINCMPL, at tag or text, line n, file 
file-spec 

The file containing cross reference symbols is incomplete. 
filename 

Fatal: During the reading of the file containing cross reference symbols, 
an error was detected that indicates that the file was not recorded 
correctly. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

XRFINVALD, at tag or text, line n, file 
file-spec 

The file containing cross reference symbols is invalid. 
filename 

Fatal: The file was opened without error, but it does not contain cross 
reference symbols. 

User Action: The wrong file is being referenced. Check the file name 
supplied with the /PROFILE qualifier. 
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XRFNORENM, at tag or text, line n, file 
file-spec 

The temporary cross reference file cannot be renamed to 
filename 

Fatal: The tag translator creates a temporary cross reference file with 
a file type TMP. When the file is complete, it renames it with a file type 
XREF. The rename operation has failed. 

(You must have Delete privileges for the directory in which the TMP file is 
being renamed.) 

User Action; If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 
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B.3 Text Processor Messages 

ATPT, Font was read at number pt 

Informational: This is an internal error. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

BADALPHA, Improper alphabetic constant 

Warning: Text formatter expected to scan a constant consisting only of 
letters. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

BADCHAR, Text line contains an invalid character 

Warning: Text formatter could not scan a character from the current 
input line. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

BADCODE, Bad code number: value, must be between smaller number and 
larger number 
using zero instead 

Warning: Text formatter expected to find a code value within the range 
shown. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

BADCS, Bad control sequence: Command 

Warning: Text formatter could not understand how the user meant to use 
the shown command in the current context. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

BADDISC, Improper discretionary list. Must contain only 
kerns and boxes 

Warning: Discretionary list contained unexpected information. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 
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BADDISCMATH, Illegal discretionary break in math mode. 

The third part of a discretionary break must be empty 
in this mode. Attempting to recover... 

Warning: Discretionary break was improperly coded. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

BADDUMP, Cannot \ dump inside a group 

Warning: Command \ dump occurred when there was one group or more 
still active. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

BADFONTFMT, Fatal font format file error 

Error: Text formatter could not load the font format file, or the font 
format file was fatally flawed. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

BADFRACTION, Ambiguous fraction ignored. 

Warning: Text formatter could not determine the meaning of a fraction. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

BADGLUE, Infinite glue. Attempting to recover 

Warning: Text formatter was asked to typeset a box using infinite glue. 
Glue was made finite and the text formatter attempted to continue. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

BADHALIGN, Improper \halign 

Warning: Command \halign is invalid in current context. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

BADHRULE, Cannot use \hrule in an \hbox. 

Use \ leaders or \hrulefill instead 

Warning: Command \ hrule is invalid in current context. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 
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BADHYPHEN, Improper \hypenation ignored. 

Must contain only letters and hyphens 

Warning: Text formatter can only read letters and hyphens in a 
hyphnation pattern. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

BADUYPHFMT, Fatal hyphenation format file error 

Error: Text formatter could not load the hyphenation format file, or the 
hyphenation format file was fatally flawed. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

BADLASTBOX, \box255 is not empty, attempting to continue 

Warning: Text formatter expected \box255 to be empty. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

BADLEADERS, \ leaders not followed by proper glue 

Warning: Glue specifiaction was not valid in the current context. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

BADLETINPAT, Non-letter found in \ patterns 

Warning: Text formatter can only read letters in a pattern. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

BADLIMIT, Ignoring misplaced \ limits or \ nolimits command 

Warning: Text formatter did not expect to see \ limits or \ nolimits in this 
context. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

BADMACROFMT, Fatal macro format file error 

Error: Text formatter could not load the macro format file, or the macro 
format file was fatally fiawed. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 
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BADMAG, Illegal magnification ratio: had number, value set to good number 

Warning: Text formatter could not set the magnification to the requested 
value. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

BADMATHCHAR, font number font-number is missing this character: 
character 

Warning: Text formatter could not typeset the character shown, because 
that character was missing from the font shown. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

BADMATHDELIM, Inserted missing or misplaced math delimiter 

Warning: Text formatter became confused while closing a math formula. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

BADNOALIGN, \noalign can only appear after \cr 

Warning: Command \ noalign is not valid in the current context. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

BADOMIT, \omit can only appear after \cr or & 

Warning: Command \ omit is not valid in the current context. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

BADOUTLOOP, Output loop repeated number of cycles times without doing a 
\ shipout 

Attempting to recover. Increase \ maxdeadcycles if neccesary 

Warning: Text formatter cycled through its output loop too many times 
without doing a \ shipout. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 
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BADPARAMNUM, Illegal parameter number 

Warning: Text formatter became confused while scanning parameters to 
a macro. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

BADPARAMSEQ, Parameter was numbered out of sequence 

Warning: Text formatter became confused while scanning parameters to 
a macro, because a parameter was numbered out of sequence. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

BADPATTERNS, Bad \ patterns 

Warning: Text formatter became confused while reading a pattern. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

BADPREAMBLE, Cannot nest alignment preambles 

Error: Text formatter became confused during current alignment, because 
it found an alignment within an alignment. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

BADPREFIX2, Can’t use \ long or \ outer with command 

Warning: Text formatter will ignore \long or \ outer or \ global when 
used with the shown command. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

BADPREFIX3, Can’t use \long or \ outer or \ global with command 

Warning: Text formatter will ignore \ long or \ outer when used with the 
shown command. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

BADPREVGRAF, \ prevgraf = number. Value must be positive 

Warning: Text formatter expected to see \ prevgraf specified with a 
positive value. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 
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BADPT, Bad font size = number pt, replaced by 10 pt 

Warning: Text formatter attempted to read a font at an improper font 
size. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. ) 

BADUNBOX, Cannot unbox a hbox or vbox in Text formatter mode mode 

Warning: Command unbox is invalid under current circumstances. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

BADUNIT, Bad unit of measure, replaced by string 

Warning: Text formatter could not use the requested unit of measure. 
Unit was changed to shown value. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

BADVALUE, quantity = quantity. Value must be between smaller number and 
larger number 

Warning: Text formatter was expecting to read a value within the range 
shown. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

BUFFERSIZE, Maximum number of characters in the input buffer is number 

Informational: User has exceeded total size of text formatter’s input 
buffer. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

CANNOTRESETMAG, Cannot change magnification, using old value: number 

Warning: Text formatter can only set magnification value once. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 
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CONFUSION, Text formatter became confused doing this: Command, 
job is aborting 

Error: Text formatter became confused doing the shown activity and had 
to exit. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

DIMENTOOBIG, Dimension too large 

Warning: Text formatter became confused while scanning a dimension, 
because the dimension was too big. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

DISCTOOLONG, Discretionary list is too long. Attempting to recover 
Warning: Discretionary list was too long. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

DOUBLESUB, Double subscript 

Warning: Text formatter found a quantity with two subscripts. In these 
cases, x^l'^2 will be treated like x'^l{}‘^2. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

DOUBLESUPER, Double superscript 

Warning: Text formatter found a quantity with two superscripts. In these 
cases, x_l_2 will be treated like x_l {}_2. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

DURING, Error occurred during a command 

Warning: Error occurred during a specified command or control sequence. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

DURINGOR, Error occurred during a command or string 

Warning: Error occurred during one of the two commands or control 
sequences shown. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 
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EMERGENCYSTOP, Job is aborting 

Error: Text formatter became confused and had to exit. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

ENDDURING, \end occurred during command 

Warning: Command \ end occurred unexpectedly. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

ENDINGROUP, \ end occurred inside group at level Number 

Warning: Command \end occurred when there was one group or more 
still active. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

EOF, Unexpected end of file 

Warning: Text formatter encountered the end of the current file 
unexpectedly. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

EOP, Paragraph ended before the following completed: 

Warning: Text formatter encountered the end of a paragraph 
unexpectedly. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

EXTRATAB, Extra \halign or & in alignment has been changed to \cr 

Warning: Text formatter found extra or unexpected \halign or &. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

FILENAME, file-name 

Informational: Identifies current file being used as input. 

User Action: This message always occurs in conjunction with other 
messages. Action depends upon associated message. 
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FONTDIMEN, The following font has only number fontdimen parameters 
To increase the number of font parameters you must use 
\ fontdimen immediately after the \font is loaded 

Warning: Current font has too many parameters. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

FONTERROR, Error occurred in the following font: 

Warning: Text formatter found an error in the current font. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

FONTMEMSIZE, Font memory size = number words 

Informational: Reports the total size of text formatter’s font memory. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

FONTTYPE, Font was declared by: string 

Warning: Identifies the font’s type, e.g. \ preloaded. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

FUNNYCS, Missing control sequence inserted 

Warning: Text formatter became confused while defining a control 
sequence. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

HPOOLSIZE, Hyphenation string memory size = number bytes 

Informational: User has exceeded total size of text formatter’s 
hyphenation string memory. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

IDENT, string 

Informational: Identifies the current version of the text formatter. 

User Action: None. 
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IGNORED, Extra command ignored 

Warning: An unneccesary text formatting command was found. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

IGNOREDTEXT, All text was ignored after line string 

Warning: Text formatter could not typeset any of the following lines 
shown. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

IGNORING, Ignored the following: command 

Warning: Text formatter encountered an unexpected command and 
ignored it.) 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

IMPROPERCMD, Improper command found: command 

Warning: command shown is not valid in the current context. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

INCOMPLETECMD, Incomplete command found: command 

Warning: Text formatter became confused while tr 5 dng to scan the shown 
command. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

INFO, text - on page number 

Informational: A text formatting macro has generated an informational 
message. A problem occurred while the text formatter was processing the 
output, text provides a description of the problem. In most cases, the file 
will continue processing successfully and you can examine the output. The 
message indicates the page on which the problem occurred, and you can 
use this information to correct the problem 

User Action: The following is a list of the messages you may see and the 
associated action that will correct the problem. 

• Callout number 0 is undefined. Using 1. 

You specified a <CALLOUT> or <CO> tag as 0. 
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• Callout number exceeds 99. Using 99. 

A <CALLOUT> or <CO> tag’s value is greater than 99. POSTSCRIPT 
output devices cannot print numbers greater than 99. 

• Error in setting note type; using default. 

A local or personal DESIGN file specified an invalid value for the 
\noteformattype. Refer to VAX DOCUMENT Designing Doctypes for 
value values. 

• Error. Maximum number of table footnotes exceeded. 

You specified too many <FOOTNOTE> tags for a table. The largest 
number that is allowed is 12. 

• Error pushing/popping revision bars. 

<MARK> and <ENDMARK> tags are not evenly matched or are not 
suppressed around heading levels in the correct sequence. If you 
receive this message and are under a service contract with Digital, 
call your customer service center. Otherwise, submit a Software 
Performance Report. 

• Possible problem in the output of revision bars. 

The text formatter encountered a complex situation while a revision 
mark (from the <MARK> tag) was active. Examine your output closely 
to determine if the revision mark output is correct. A revision mark 
may not appear or it may appear where you did not intend it to. If 
there is a problem, you can change your source file to decrease the 
range in which a revision mark is active. For example, if you have 
changes in two rows of a table, you might place the <MARK> and 
<ENDMARK> tags inside each of the two <TABLE_ROW> tags instead of 
around the entire table. 

• Figure is too large for a single page. 

A value specified in <FIGURE_SPACE> or <FIGURE_FILE> exceeds the 
depth of the output page. The text formatter uses only the depth of 
the page. 

Correct the invalid depth argument in the SDML file. 

• The <FOOTREF> tag before the <FOOTNOTE> tag in the table is ignored. 

A tag <FOOTREF> tag occurs in a table for which no corresponding 
<FOOTNOTE> tag occurs. You must specify footnotes in tables at the 
beginning of the table, before any references to them occur. 

• Graphics files cannot be included on this device. 

A <FIGURE_FILE> or <IC0N_FILE> tag was encountered that specified 
a graphics file to be included on a device that does not support the 
inclusion of graphics. The tag is ignored. 

• An index subentry is more than 4 levels deep; it is ignored. 

An indexing tag (<X> or <Y>) contains more than four <XSUBENTRY> 
tags. Only four levels of subentry are allowed. 

Correct the indexing tag by removing the excessive subentries. 
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• Included files are not allowed to float. 

An included text formatter file in a figure is assumed to be multipage 
and cannot float. 

Remove the FLOAT attribute. 

• Internal error while processing a table. 

The text formatter received bad input. Submit an SPR. 

• Invalid table of contents entry. 

A local or personal doctype specified an invalid value for a table of 
contents entry. Correct the table of contents entry to use a valid code. 

If this error occurs using a standard VAX DOCUMENT design, submit 
an SPR. 

• Monospaced example is too big to keep. 

You specified the keyword KEEP as an attribute to a <CODE_EXAMPLE> 
tag or other tag that specifies a monospaced example. The number of 
lines in the example cannot fit on a single page of output. 

Remove the keyword KEEP from the tag and provide <VALID_BREAK> 
tags to indicate acceptable page break points. 

• A multipage figure is not allowed to float. 

You specified a figure with both the attributes FLOAT and 
MULTIPAGE. Multipage figures cannot float; the text processor 
outputs it at the location of its occurrence in the source file. 

Remove the FLOAT attribute. 

• There is no template heading defined at this level; using level two. 

• A <PAGE> tag is ignored in a floating figure. 

A <PAGE> or <FINAL_CLEANTJP>(PAGE) tag is encountered in a figure that 
has the default attribute FLOAT. 

Specify <FIGURE_ATTRIBUTES>(MULTIPAGE) for all figures that are more 
than a page in length. 

• A <PAGE> tag is ignored in taa ble that is not multipage. 

A <PAGE> or <FINAL_CLEANIJP>(PAGE) tag is encountered in a table that 
has the default attribute FLOAT. 

Specify <TABLE_ATTRIBUTES>(MULTIPAGE) for all tables that are more 
than a page in length. 

• Possible table paging problem. 

A table that is output on more than one page is being forced to break 
across pages without explicit page breaking or sufficient valid table 
break points. 

In most cases, the output is acceptable. The text formatter makes 
its best decision about breaking tables across pages when there are 
<TABLE_ROW_BREAK> tags to specify the first and last valid breaks for 
the table. 
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Revision bars cannot be output on this device, 

<REVISI0N>, <MAREC>, and <ENDMARK> tags cannot be processed for this 
device. No change bars are printed. 

A <SPAN> tag at the end of a table column is ignored. 

The <SPAN> tag, which specifies that text is to span 2 or more columns 
in a table, must precede the text in the argument. For example, 

<TABLE_ROW>(<SPAN>(3)This text sits across all three columns) 

Move the <SPAN> tag to the beginning of the ta^s argument. 

The table is too wide for the page. 

The values you specify in the <TABLE_SETUP> tag result in a table that 
does not fit on the current page. Check the arguments you specified 
to the <TABLE_SETUP> tag and decrease them. You are able to tell from 
the output how much of the table is excessive. 

A <TABLE_HEADS> tag preceding a <TABLE_SETXJP> tag is ignored. 

You must specify table headings following the <TABLE_SETUP> tag. 
Move the <TABLE_HEADS> tag SO that it precedes the <TABLE_SETUP> 
tag. 

A <TABLE_HEADS> tag within a <TABLE_UNIT> tag is ignored. 

Do not use the <table_HEADS> tag inside <tAble_UNIT> tag sequences; 
use the <table_unit_HEADS> tag instead. 

A <TABLE_ROW> tag is encountered outside of a <TABLE> tag. 

You specify a <table_ROW> tag, but there is no <TABLE> tag. The tag is 
ignored. Correct the file so that a valid <TABLE> tag precedes it. 

<TABLE_ROW_BREAK> tags in a single-page table are ignored. 

You specify the <TABLE_ROW_BREAK> tag in a table that has the 
attribute KEEP. 

Remove the KEEP attribute from the table or remove the 
<TABLE_ROW_BREAK> tag. 

A <TABLE_UNIT_HEADS> tag outside of the table unit ignored. 

A <TABLE_UNIT_HEADS> tag is encountered before a <TABLE_UNIT> tag to 
begin a table unit. 

Remove the tag or insert a <TABLE_UNIT> tag to enclose a table unit. 
Tracing is disabled in VAX DOCUMENT. 

An instruction to accumulate tracing information occurred in a TEX 
file. VAX DOCUMENT does not support these instructions. 

Too many columns specified for multi-column output. 

A local or personal doctype specifies too many columns of output. 

If this error occurs using a standard doctype, submit an SPR. 
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INITEXPAT, \ patterns can only be used by Initex 

Warning: Text formatter only recognizes \ patterns when it is building 
format files, not during a run of VAX DOCUMENT. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

INSERTED, Missing command inserted 

Warning: Missing command was inserted into the input stream. 

User Action: If you receive this message and are under a service cpntract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

INSERTHBOX, \ insert can only be added to a \vbox 

Warning: Command \ insert is not valid in the current context. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

INSERTING, Inserting command 

Warning: Text formatter attempted to resolve an unexpected situation by 
inserting shown command into the input stream. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

INSUFEXTFON, Math formula deleted: Insufficient extension fonts 

Warning: Math formula could not be typeset because extension fonts were 
inadequate or missing. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

INSUFSYMFON, Math formula deleted: Insufficient symbol fonts 

Warning: Math formula could not be typeset because symbol fonts were 
inadequate or missing. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

INTERNALERROR, Internal error number: error number. Job is aborting 

Error: Text formatter found an internal inconsistency. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 
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LINE, Error occurred on or around line number: number 

Informational: Reports the current line of input that the text formatter 
is processing. 

User Action: This message always occurs in conjuction with other 
messages. Action depends upon associated message. 

LINETOOLONG, Line too long by Integer.remainder points 

Informational: The text formatter found a very lengthy line. 

User Action: This message always occurs in conjuction with other 
messages. Action depends upon associated message. 

LINETOOSHORT, Line too short - on page Page number 

Informational: The text formatter found a line that was too short. 

User Action: This message always occurs in conjuction with other 
messages. Action depends upon associated message. 

MATHOVERFLOW, Arithmetic overflow 

Warning: Result of a mathematical operation was too large. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

MAXFONTS, Maximum number of fonts is: number 

Informational: User has exceeded maximum number of fonts. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

MAXGROUPS, Maximum number of groups is: number 

Informational: User has exceeded maximum number of groups. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

MAXHASH, Maximum number of entries in hash table is: number 

Informational: User has exceeded maximum number of entries on text 
formatter’s hash table. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 
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MAXHSTRINGS, Maximum number of hyphenation strings is: number 

Informational: User has exceeded the maximum number of hyphenation 
strings. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

MAXHYPHS, Number of hyphenation exceptions is: number 

Informational: User has exceeded maximum number of hyphenations. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

MAXINPUTS, Maximum number of simultaneous input files is: number 

Informational: User has exceeded maximum number of simultaneous 
input files. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

MAXNESTS, Maximum number of simultaneous semantic levels is number 

Informational: User has exceeded maximum number of simultaneous 
semantic levels in text formatter. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

MAXPARAMS, Maximum number of simultaneous text macro parameters is 
number 

Informational: User has exceeded maximum number of parameters to a 
macro. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

MAXSAVE, Maximum number of entries on save stack is: number 

Informational: User has exceeded maximum number of entries on text 
formatter’s save stack. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

MAXSTRINGS, Maximum number of strings is: number 

Informational: User has exceeded maximum number of strings. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 
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MEMORYSIZE, Main memory size = number words 

Informational: User has exceeded the total size of the text formatter’s 
main memory. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

MESSAGE, text - on page number 

Warning: Text formatter macro generated a warning message. The 
following is a list of possible messages and actions. 

User Action: See the action associated with each of the following 
messages. 

• Error in the window size. 

An error occurred in a local or personal doctype; an invalid value was 
specified in a \ window. 

If this error occurs in a standard doctype, submit an SPR. 

• Internal error in setting block indents. 

Too many arguments are specified to \ blockindents, or the values were 
not valid. This error should only occur if a local or personal DESIGN 
file contains an invalid value. 

• Internal error in figure key definition. 

Submit an SPR. 

• Too many floating figures. 

There are too many <FIGURE> tag sequences within a short span of 
text, and the default attribute “float” is in effect for all of them. 

The text formatter cannot produce meaningful output when there are 
too many figures that are floating. When you have a large number of 
figures in a short span of text, you should use the 
<FIGURE_ATTRIBUTES>(KEEP) tag to keep them in sequential order. 

• No room for a new [item]. 

Internal use. 

MISSINGBOOL, ’or’=’or’ 

Warning: Text formatter expected to scan one of the boolean values 
shown. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. Determine which boolean value is needed 
and insert it in the right place. 
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MISSINGLBRACE, Possible missing { 

Warning: Text formatter did not see an {. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

MISSINGRBRACE, Possible missing} 

Warning: Text formatter did not see an }. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

MODE, Error occurred in string mode 

Informational: Reports the current mode that the text formatter is in. 

User Action: This message always occurs in conjunction with other 
messages. Action depends upon associated message. 

MUERROR, Mismatched glue units. Assuming that lmu=lpt 

Warning: Text formatter scanned glue specifications that are 
incompatible. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

NOBOX, Expected to find \hbox or \vbox or 

\ copy or \ box or something like that. 

Some text may be missing from output. 

Warning: Text formatter expected to find a box. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

NOEND, No \end was found 

Error: Text formatter expected to see an \ end command. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

NOFONTID, Could not find font identifier for the following font: 

Warning: Font identifier for the current font is missing. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 
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NOINPUTPAGE, no pages in input file 

Error: The input file named in an associated message contains no pages; 
therefore, there is no output to print. 

User Action: Check SDML source file to see why no text was found. 

NOINSLASTBOX, \insert255 is illegal. Changing to \insertO 

Warning: Text formatter register \insert255 cannot be used in current 
context. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

NOMATHACCENT, Changed \ accent to \ mathaccent 

Warning: The text formatter command \ accent works differently in 
formulas than it does in normal text. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

NONUMBER, Missing number, using zero 

Warning: Text formatter expected to find a number. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

NOROOM, Exceeded memory capacity: 

Error: Text formatter exceeded one of its memory capacities. The message 
immediately following indicates which quantity was exceeded. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

NOUSE AFTER, After this: command., the following is invalid: 

Warning: Text formatter cannot use the command shown in the next 
message directly after the command shown in this message. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

NUMBERTOOBIG, Number too large, using 2147483647 instead 

Warning: Text formatter could not use specified number because it is too 
big. Text formatter used 2147483647 instead, which is the largest number 
possible in that context. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 
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ONEOFFOUR, Some or all of the following 4 messages apply: 

Warning: One or more of the four messages that follow on your screen 
apply. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

ONEOFTWO, One or both of the following messages apply: 

Warning: One or both of the two messages that follow on your screen 
apply. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

ONPAGE, on page number 

Informational: Identifies the current page being output. 

User Action: This message always occurs in counjunction with other 
messages. Action depends upon associated message. 

OUTFILENAME, file-name 

Informational: Identifies the output file name. 

User Action: None. 

PAGESOUT, number page(s) written. 

Informational: Reports the number of pages written to the output file. 
User Action: None. 

PAGETOOBIG, Cannot ship out huge page. More than 18 feet wide or long. 

Warning: Text formatter became confused during typesetting of current 
page because page was too large. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

PAGETOOLONG, Page too long by string.string points 

Warning: Text formatter could not fit the contents of the current page 
into boundaries of current page. Such errors are common with a line 
printer because it is monospaced. 

User Action: Examine the output on the page shown to determine if 
there is a problem with the coding of the SDML file. You can ignore the 
problem if it is not serious, or you can change destinations or change the 
doctype, if possible. 
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PAGETOOSHORT, Page too short - on page Page number 

Informational: The text formatter had trouble composing the current 
page. There were not enough lines to reach the bottom. Such errors are 
common with a line printer because it is monospaced. 

User Action: Examine the output on the page shown to determine if 
there is a problem with the coding of the SDML file. You can ignore the 
problem if it is not serious, or you can change destinations or change the 
doctype, if possible. 

PATTERNEXISTS, Duphcate pattern found 

Warning: Text formatter found a duplicate pattern. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

PATTERNMEMSIZE, Hyphenation pattern memory size = number words 

Informational: User has exceeded total size of text formatter’s 
hyphenation memory. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

POOLSIZE, String memory size = number bjrtes 

Informational: User has exceeded total size of text formatter’s string 
memory. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

RUNAWAY, Runaway kind of text 

Warning: Text formatter became confused while scanning the shown kind 
of text. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

SCALED, Font was scaled: number 

Informational: This is an internal error. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

SHOWCONTEXT, text 

Informational: Displays the input stream that the text formatter was 
attempting to read when something went wrong. 

User Action: This message always occurs in conjunction with other 
messages. Action depends upon associated message. 
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SHOWTOKEN, text 

Informational: Displays part of text formatter’s current token list. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

TIGHTSPACING, Insufficient inter-word spacing - on page Page number 

Informational: The text formatter had trouble composing a line - there 
was not enough white space on the line. Such errors are common with a 
line printer because it is monospaced. 

User Action: Examine the output on the page shown to determine if 
there is a problem with the coding of the SDML file. You can ignore the 
problem if it is not serious, or you can change destinations or change the 
doctype, if possible. 

TOOFEWLINES, Excess inter-line spacing - on page Page number 

Informational: The text formatter had trouble composing the current 
page. There was too much white space between the lines. Such errors are 
common with a line printer because it is monospaced. 

User Action: Examine the output on the page shown to determine if 
there is a problem with the coding of the SDML file. You can ignore the 
problem if it is not serious, or you can change destinations or change the 
doctype, if possible. 

TOOMANYERRORS, Error limit is 30 

Error: Text formatter found more than 30 errors. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

TOOMANYLINES, Insufficient inter-word spacing - on page Page number 

Informational: The text formatter had trouble composing the current 
page. There was not enough white space between the lines. Such errors 
are common with a line printer because it is monospaced. 

User Action: Examine the output on the page shown to determine if 
there is a problem with the coding of the SDML file. You can ignore the 
problem if it is not serious, or you can change destinations or change the 
doctype, if possible. 

TOOMANYPARAMS, More than nine parameters were passed to a macro 

Warning: Text formatter became confused while scanning parameters to 
a macro because there were too many paramters. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 
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TRACE, text 

Informational: User has turned on text formatter’s tracing mechanism. 
Text contains information about VAX DOCUMENT’S text formatter’s 
internals. 

User Action: None. 

UNDEFINEDCS, Undefined control sequence 

Warning: Text formatter encountered an undefined control sequence. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

UNKNOWNUNIT, Dimension unit must be: em,ex,in,pt,pc,cm,mm,dd,cc,bp,sp 

Warning: Text formatter expected to read one of the dimensions shown. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

USINGZERO, Bad value, must be between smaller number and larger 
number, using zero instead 

Warning: Text formatter expected to scan a value in the range shown. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

VSPLITHBOX, Attempted to \vsplit a \hbox 

Warning: Command \vsplit is not valid in current context. 

User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

WIDESPACING, Excess inter-word spacing - on page Page number 

Informational: The text formatter had trouble composing a line; there 
was too much white space on the line. Such errors are common with a line 
printer because it is monospaced. 

User Action: Examine the output on the page shown to determine if 
there is a problem with the coding of the SDML file. You can ignore the 
problem if it is not serious, or you can change destinations or change the 
doctype, if possible. 
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B.4 Device Converter Messages 

BADFILABORT, file bad—aborting run 

Error: The device converter cannot use the font file named in an adjacent 
message. 

User Action: Another file may have been given the same name. Use the 
DIRECTORY/FULL DCL command to see that the size and format are 
similar to other font files. If necessary, reinstall the font data. 

BADFONT, font file bad—^using blanks 

Warning: The file that describes the font design is unusable. The 
program will substitute blanks for the characters in this font. 

User Action: Use the DIRECTORY/FULL DCL command to see if the 
size and format of this file resembles other font files. If necessary, reinstall 
the font data. 

BADFONTSIZE, internal font error: font 

string scaled size out of range. 

Error: The device converter has detected a font size that is out of range. 
This may be a problem with the font file itself, or an internal device 
converter problem. 

User Action: None. 

BADINCDVI, bad file format or error in reading included DVT file 
filespec 

Error: The device converter has encountered a read error or illegal file 
format in an included DVI file. See the previous message. 

User Action: Regenerate the DVI file by running Document again. 
BADINCLUDE, included file is bad 

Warning: The program has encountered errors in processing the contents 
or index file requested. 

User Action: Check that previous processing steps generated the 
contents or index file expected, because the included file may be an old, 
incompatible file, it may be another file with the same name, or it may be 
the correct file made unreadable because of an I/O error. 

BADMETRIC, bad metric file 

Error: The device converter has encountered errors in processing the 
indicated font metric file. 

User Action: This may be another file named the same. Check the file 
size and format with the DIRECTORY/FULL DCL command to see if it 
resembles other font metric files. If necessary, reinstall the font data. 
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BADPAPERSIZE, illegal papersize string string, ignored 

Warning: An unsupported papersize string was encountered from the 
design file. 

User Action: Correct the design to specify one of the accepted papersizes. 

BADPOSTAMBLE, error in postamble of file 
string 

Error: The device converter encountered a read or file format error in the 
postamble of the named file. 

User Action: None. 

BADPOSTFORMAT, illegal postamble format 

Error: The device converter encountered a read or file format error in the 
postamble of the named file. 

User Action: None. 

BADPREAMBLE, error in DVI file’s preamble. 

Error: The device converter cannot accept the DVI file’s preamble. 

User Action: Regenerate the DVI file by running Document again. 

BADPRIMDVI, bad file format or error reading primary DVI file: 
filespec 

Error: The device converter has encountered a read error or illegal file 
format in the primary DVI file. See the previous message. 

User Action: Regenerate the DVI file by running Document again. 

BADPXLFILE, bad file format or error in reading PXL bitmap font file 
filespec 

Error: The device converter encountered a read error or illegal file format 
in trying to read metrics or bitmap data for a PXL bitmap font. 

User Action: Reinstall the font data. 

BADSPECIAL, unknown DVI file special command code encountered. 

Error: The special command code read does not match any existing 
defined specials. 

User Action: None. 

BOOKABORT, aborting run—book string not created 

Error: The device converter received a fatal error; no DECW$BOOK file 
is made. 

User Action: Check the previous message to see what caused the fatal 
condition. 


B-83 



Messages 

Device Converter Messages 


BOOKBUILT, book was successfully built 

Informational: The book was completed without any fatal errors. 

User Action: None. 

CANNOTCONNECT, cannot connect along a diagonal 

Warning: While attempting to draw change bars, the program has 
encountered an attempt to draw a nonvertical line. Only vertical change 
bars are allowed. 

User Action: Look in the macros that describe change bar positioning for 
errors and inconsistencies. 

CANNOTCREATE, cannot create output file 

Error: The program cannot create an output file. 

User Action: Check that the output directory exists, that the user has 
permission to write in it, and that the device is available and is not full. 

CANNOTOPEN, cannot open input file 

Error: The program cannot open the input DVI file. 

User Action: Check that the input directory exists, that the file exists or 
was created by earlier processing steps, that the user has permission to 
read the file, and that the device is available. 

CANTCREATE, cannot create output file 
filespec 

Error: The device converter cannot open the named file for write. 

User Action: See next message. 

CANTOPEN, cannot open file 
filespec 

Error: The device converter was unable to open the named file. 

User Action: None. 

CONFIGERROR, error in configuration file 

Error: An error has been detected in reading the file that describes 
PostScript fonts. An adjacent error message gives more details. 

User Action: Check that the device is available and that the user has 
permission to read the file. Take the action suggested by the adjacent 
error message. If necessary, reinstall the font data. 

DIFPAPERSIZE, papersize in design but already specified on cmd line, 
using cmd line value string 

Warning: A papersize option was encountered both on the command line 
and in the design file. The command line value will be used. 

User Action: Specify the desired papersize in the design file. 
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DOCSETUP, error in generating document setup area. 

Error: The device converter experienced a fatal error while attempting 
to generate the document setup area, which contains all of the font 
definitions needed in the document. 

User Action: See adjacent messages. 

DVIEOF, premature end-of-file in DVI file 
filespec 

Error: The device converter encountered a premature end-of-file while 
reading the named DVI file. 

User Action: Regenerate the DVI file by running Document again. 

EXTNESTING, Extensions are being nested 

Informational: Extensions are being nested. 

User Action: This is not supported. Check the output carefully. 

HOTSPOTERR, HOTSPOT crosses Tex page boundary: 
string 

Informational: Gives the symbolic name of reference and the last chunk 
title that was defined. 

User Action: Using the symbolic name and the title locate the reference 
being broken up by the page break and insert an <0NLINE_CHUNK> tag 
before it. 

EXTNESTING, Extensions are being nested 

Informational: Extensions are being nested. 

User Action: This is not supported. Check the output carefully. 

HOTSPOTERR, HOTSPOT crosses Tex page boundary: 
string 

Informational: Gives the symbolic name of reference and the last chunk 
title that was defined. 

User Action: Using the symbolic name and the title locate the reference 
being broken up by the page break and insert an <0NLINE_CHUNK> tag 
before it. 

FCCANTOPEN, cannot open font configuration file 
filespec 

Error: The device converter was unable to open the named file. 

User Action: None. 

FIGFILERR, Error encountered while reading: 
filespec 

Informational: An error was returned when reading the figure file. 

User Action: Check to make sure the figure is not corrupted. 
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FIGFILOPN, cannot open figure file 

Warning: The program cannot find the figure file named, or can find it 
but cannot open it. 

User Action: Check that you have specified the right filespec, that the file 
exists in the path specified (or in the current default directory, if no path 
is specified), that you have permission to read that file, and that the file is 
not locked by the action of some other program running at the same time. 

FIGNOTFND, cannot find figure image in figure file 

Warning: The figure file named in an adjacent message does not contain 
the proper codes to identify the type of figure expected. White space 
appears where the figure would be placed. 

User Action: Check the figure file. 

FILEI, error in reading file 
filespec 

Error: The device converter encountered an error while reading the 
named file. 

User Action: None. 

FILENESTING, one included file cannot include another file 

Warning: One contents or index file may not include another. 

User Action: Check the macros that describe contents and index files to 
see that they are correctly generating the filespecs. Check that the filespec 
generated for the contents or index file is the same as an existing file. 

FILEO, error in writing file 
filespec 

Error: The device converter encountered an error while writing to the 
named file. 

User Action: None. 

FNTCONFIG, description for font 

string missing or illegal in configuration file. 

Error: The specified font is not present, or not fully described, in the file 
that describes PostScript fonts. 

User Action: If necessary, reinstall the PostScript support. 

FNTFILEREF, font referenced in file 
filespec 

Error: The named DVT file contains a reference to the above font. 

User Action: None. 
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FONTCONFIG, Font description missing or illegal in configuration file 

Error: The specified font is not present, or not fully described, in the file 
that describes PostScript fonts. 

User Action: If necessary, reinstall the PostScript support. 

FONTERROR, error in font 
string 

Warning: An error has occurred while processing the named font. The 
specific problem is identified in an adjacent message. 

User Action: Note the name of the font. Take the action suggested by the 
adjacent error message. 

FONTTOOBIG, too many characters in font—^limit is 188 

Error: The document uses too many characters from the named font. 

User Action: Reinstall the font files. If the problem persists, and if you 
are under a service contract with Digital, call your customer service center. 
Otherwise, submit a Software Performance Report. 

FSEEK, fseek internal error, file = 
string 

Error: The device converter encountered an internal error while 
attempting to fseek in the named file. 

User Action: None. 

IDENT, string 

Informational: Reports the version of the program in use. 

User Action: None. 

IGNORING, ignoring included input file 
filespec 

Warning: The program cannot process the included DVI file for the reason 
specified in an adjacent message. 

User Action: Note the name of the file. Take the action suggested by the 
adjacent error message. 

INCDVICANTOPEN, cannot open included DVI file 

filespec 

Warning: The device converter was unable to open the named file. 

User Action: None. 

INCLUDED, File filespec was successfully included 

Informational: The named file was succesfully read and stored 
User Action: None. 


) 
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INCLUDING, including input file: 
filespec 

Informational: Reports that the program is processing a DVI file other 
than the file named on the command line. The file is typically a contents 
or index file. 

User Action: None. 

INITMEM, ran out of memory while initializing device converter 

Error: This memory error occured very early in the device conversion. 
User Action: None. 

INPUTBAD, bad input file—aborting run 

Error: The program has encountered errors in the named input file and 
cannot continue. 

User Action: Check the messages generated by earlier processing steps 
to see if a complete DVI file was created. 

INPUTFILE, input file is: 

filespec 

Informational: Reports the name of the primary DVI file, that is, the file 
named on the command line. 

User Action: None. 

INTERNALERROR, internal error 

Error: A problem internal to the device converter prevents it from 
continuing. 

User Action: This sometimes represents a document so large or complex 
that it exceeds internal buffer sizes. Sometimes you can work around 
this by running contents and index processing as separate jobs, rather 
than including them in place. You may be able to process the document 
in two or more pieces by using the STARTING_PAGE and ENDING_ 
PAGE or NUMBER_OF_PAGES parameters to the device converter. If you 
receive this message and are under a service contract with Digital, call 
your customer service center. Otherwise, submit a Software Performance 
Report. 

INVALIDDATE, Invalid date specification. Use the dd-mm-yyyy format 
Error: The converter has found an invalid date specification. 

User Action: use the dd-mm- 5 ^ 3 ^ format to specify the date 

INVALIDOPTN, invalid option 

Error: This DVT special command contains an option not supported by 
this device converter, or the program cannot find an option at all. 

User Action: Check to see if you have requested a figure file, contents 
file, index file, change bars, or other function which is not supported for 
this destination; check for errors in the macros that generate this special 
command; check if the special has all required arguments 
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INVALIDPOINT, invalid point number number 

Warning: An error has occurred in the macros used to describe change 
bars. Specifically, an attempt has been made to locate a point off the page, 
or the point is incorrectly described. 

User Action: Look in the macros that describe change bar positioning for 
errors and inconsistencies. 

IN_CANTCLOSE, cannot close input file 
filespec 

Warning: Error in closing the file. Processing continues. 

User Action: None. 

NOCONTENTS, no contents file found - verify that 

1 - The command line has/CONTENTS specified 

2 - The document has a CONTENTS_FILE tag. 

Error: No contents file was processed, which causes a fatal error in 
bookbuilding for the Bookreader. 

User Action: Make sure there is a contents file and that it is included. 

NOFILABORT, cannot open file—aborting run 

Error: The device converter cannot open the named file. 

User Action: Check to see that the device is available, that the file exists, 
and that the user has privileges to access that file. 

NOFONT, cannot open font file—^using blanks 

Warning: The device converter cannot open the named font file. 

User Action: Check that the device exists and is available, and that the 
user has permission to read the file. 

NOFONTDEF, no font defined for font select 
string 

Error: none. 

User Action: None. 

NOINCLUDE, cannot open included file 

Warning: The device converter cannot open the contents or index file 
named in the adjacent message. Either the pathname and filename are 
incorrect, or the program cannot gain access because of file protection or 
locking by another process. Processing will continue without this file. 

User Action: Check that the named file exists and that the user has 
access to it. 
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NOINPUTPAGE, no pages in input file 

Error: The input file named in an adjacent message contains no pages; 
therefore, there will be no output to print. 

User Action: Check to see if errors reported in earlier processes caused 
there to be no pages generated. 

NOMETRIC, cannot open metric file 

Error: The font metric file named in an adjacent message does not exist, 
or the user does not have access to it because of file protection or problems 
with the device. 

User Action: Check that the file exists and is available, and that the 
user has access to it. Check that the user is specif 3 dng a DVI input file 
appropriate for the destination requested. 

NOSEXELIMAGE, cannot find sixel image in figure file 

Warning: The figure file named in an adjacent message does not contain 
the command sequence that identifies a sixel image. White space appears 
where the figure is expected. 

User Action: Check the figure file. For LN03 use, it must be a sixel file. 

NOSUBSTITUTE, no adequate alternate font found 

Error: The text formatter has requested a down-loaded font for which the 
device converter cannot find a reasonable substitute. 

User Action: Check the document design for the fonts used. Check that 
the corresponding font files exist at the sizes desired. 

NOSUCHUNIT, no such unit of measure 

Warning: A DVI special command used to position change bars or 
describe graphics files contains an unknown unit of measure, or no unit. 

User Action: Check the macros that describe change bar positioning or 
figure file characteristics for errors. 

OFFPAGE, cannot set text outside page boundaries 

Warning: An attempt has been made to set text outside the boundaries of 
the physical page specified. 

User Action: Check the messages from the text formatter for lines too 
long, that you specified a destination that can print a page as large as 
required by your design. Also, check to see if you specified a horizontal or 
vertical offset that will push your design off the page. 

ONPAGE, on page [string] 

Informational: Reports the number of the output page on which the 
condition reported in the associated messages occurred. 

User Action: Note this page number if you need to refer to the output. 
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OUTPUTFAIL, error writing to output file 

Error: The program encountered an error in writing to the output file. 
This usually means that the output disk is full, the user’s disk quota is 
exceeded, or the output disk has become unusable. 

User Action: Check that the output device is usable. If the disk is full or 
the user’s disk quota is used up, delete unwanted files and run the device 
converter again. 

OUT_CANTCLOSE, cannot close output file 
filespec 

Warning: Error in closing the file. Processing continues. 

User Action: None. 

PAGECOORDLOST, PAGE COORDINATION LOST string 

Error: The converter has found a page coordination problem. 

User Action: Make sure that two contents files are not being included 
and that there are no undefined symbols reported. 

PAGENOTFOUND, starting page not found 

Error: The user has specified a starting page number, but that page does 
not exist in the input file. 

User Action: Check the starting page specified and the input file 
specified. 

PAGESOUT, number page(s) written to file: 
filespec 

Informational: This reports the number of pages written to the output 
file named. 

User Action: No direct action needed; however, if the number is zero 
or less than expected, check other messages for errors or examine the 
commands, filespecs, options, and input files for problems. 

PAGETOOCOMPLEX, cannot hold all font data—^using blanks 

Warning: The amoimt of font data required to describe all the characters 
on this page will not fit in the LN03 font memory, so the characters in the 
current font vdll be represented as blanks. 

User Action: If using a design that allows you to change text_size, choose 
a smaller size, or use only one kind of emphasis on the page, if possible, or 
move portions of the text to adjacent pages. 

PASSlINCFNAMS, error on first pass through primary DVI file. 

Error: The device converter experienced a fatal error on its first pass 
through the primary DVI file in which it was attempting to generate a list 
of included filenames. 

User Action: See adjacent messages. 
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PFCANTOPEN, cannot open included ps plotfile 
filespec 

Warning: The device converter was unable to open the named file. 

User Action: None. 

PLOTFILEFAIL, cannot open figure file 

Warning: The program cannot find the figure file named, or can find it 
but cannot open it. 

User Action: Check that you have specified the right filespec, that the 
file exists in the path specified (or current default directory, if no path is 
specified), that you have permission to read that file, and that the file is 
not locked by the action of some other program running at the same time. 

PRIMDVICANTOPEN, cannot open primary DVI file 

filespec 

Error: The device converter was unable to open the named file. 

User Action: None. 

PROLOGERROR, error in prolog file 

Error: The device converter cannot read its file that contains the 
PostScript prolog for output. 

User Action: Check that the device is available, that the file exists, and 
that the user has privileges to access the file. If necessary, reinstall the 
PostScript support. 

READFCMEM, ran out of memory while reading the font configuration file 
Error: This memory error occured early in the device conversion. 

User Action: None. 

SHELFBUILT, shelf was successfully built 

Informational: The shelf was completed without any fatal errors. 

User Action: None. 

SPECIALERROR, error in \ special 
string 

Warning: This lists the text of a DVI special command as received by the 
device converter. This command is generated by macros, but may contain 
some user-specified information, such as a filespec or size. The specific 
problem associated vdth this special is described in an adjacent message. 

User Action: See the adjacent message for a description of the problem. 
If necessary, check this message for a filespec or size that may have been 
incorrectly entered in a tag describing a figure file, contents file, or index 
file. 
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SPECTOOLONG, \ special too long—^will try to process anjrway 

Warning; This DVI special command exceeds the maximum length of 
1000 characters. The program will truncate the command and try to 
process it. 

User Action: Check the macros that generate this special command; 
they may be appending too many spaces or extraneous text following the 
command. 

TITLETOOLONG, Title has been truncated to 256 characters 
Informational: The chunk title is limited to 256 characters 
User Action: Use shorter titles that will fit in the window. 

TOLONG, device & directory spec too long cannot exceed 48 characters 
Error: the complete file spec is too long. 

User Action: Move the files to the directory where the device and 
directory specs total length is 48 characters or less. 

TOOMANYDVI, too many included input files 

Warning: Too many included contents or index files have been requested. 

User Action: Remove excess <CONTENTS_FlLE> and <index_file> tags 
from the input file. 

TOOMANYFONTS, too many fonts—^limit is 100 
Error: The document contains too many fonts. 

User Action: Change the document design so it does not require so many 
fonts, or use SDML tags that do not require so many fonts, or break 
the document into separate documents, or process the contents or index 
separately. 

TOOMANYGLYPHS, too many glyphs used in all fonts combined 

Error: The document contains too many characters in too many fonts. 
The LN03 cannot hold this many characters. 

User Action: Break the device conversion of this document into two or 
more jobs, specif 5 dng the starting page and ending page or number of 
pages. End one job before the page on which this error was reported. 

UNDEFSYM, string 

Error: A reference to an undefined symbol was detected. 

User Action: Check that symbol names in references are legitimate. 
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UNRECOGOPTN, unrecognized option 

Warning: This DVI special command contains an option not supported by 
this device converter, or the program cannot find an option at all. 

User Action: Check to see if you have requested a figure file, contents 
file, index file, change bars, or other function that is not supported for 
this destination. Check for errors in the macros that generate this special 
command. 

VMBADFREE, Internal device converter error, failure to deallocate virtual 
memory 

Error: The device converter has failed 'while trying to deallocate 'virtual 
memory. 

User Action: Re'vievr any related informational messages, correct the 
problem, and reexecute the DOCUMENT command. If you are under a 
service contract 'with Digital, call your customer service center. Otherwise, 
submit a Software Performance Report. 

VMOVRFLOW, Internal device converter error, failure to allocate additional 
'virtual memory 

Error: The device converter has failed while trying to allocate additional 
virtual memory. 

User Action: Review any related informational messages, correct the 
problem, and reexecute the DOCUMENT command. This error may be 
caused by the user ha'ving too small of a pagefile quota (PGFLQUO). If so, 
increase this value and reexecute the DOCUMENT command. If you are 
under a service contract with Digital, call your customer service center. 
Otherwise, submit a Software Performance Report. 
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Index Facility Messages 

BADATTR, illegal tag argument attribute list syntax in tag 

string. , 

Error: A tag argument attribute list in the INX file contains illegal S 5 uitax 
or the INX file is corrupted. 

User Action: Try reprocessing to get a new INX file. If the problem 
persists, contact Digital. 

BADENTRYINCLUDE, warning: master, NOMASTER and BOTH on same 

entry for entry 
string 

using BOTH. 

Warning: The indexer has encountered an entry that contains MASTER, 
NOMASTER and BOTH entry inclusion attributes. It will convert this 
entry to be a BOTH entry. 

User Action: Edit the SDML file and remove the NOMASTER attribute 
from the entry. 

BADINXCHAR, Warning: illegal char/s after 
string, 

attempting to continue. 

Warning: The indexer has encountered one or more characters in between 
tags and tag arguments. The INX file may be corrupted. The indexer will 
ignore these characters and attempt to continue processing. 

User Action: Try reprocessing to get a new INX file. If the problem 
persists, contact Digital. 

BADTAG, unrecognized tag 
string 

Error: The indexer has encountered an unrecognized tag in reading the 
INX file. The INX file may be corrupted. 

User Action: Try reprocessing to get a new INX file. If the problem 
persists, contact Digital. 

BEGINENDENTRY, warning: begin and end on same entry for entry 
string 

converting to a single page-number entry. 

Warning: The indexer has encountered an entry that contains both a 
begin and end page-range attribute. It will convert this entry to be a 
single page entry. 

User Action: Edit the SDML file and separate the begin-end page-range 
entries. 
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BEGINONLY, begin page-range without end page-range for entry 
stringy treating as single entry. 

Warning: The indexer has encountered a begin page-range without a 
corresponding end page-range. It will treat the begin page-range as a 
single page number reference. 

User Action: Edit the SDML file and add an end page-range. 

CANTFREE, internal error in freeing virtual memory 

Warning: The indexer encountered an internal error in attempting to free 
some virtual memory. 

User Action: Contact Digital. 

CREATED, filespec created 

Success: The indicated output file has been created. 

User Action: None. 

CREATED, filespec created 

Success: The indicated output file has been created. 

User Action: None. 

ENDONLY, end page-reinge without begin page-range for entry 
string, treating as single entry. 

Warning: The indexer has encountered an end page-range without a 
corresponding begin page-range. It will treat the end page-range as a 
single page number reference. 

User Action: Edit the SDML file and add a begin page-range. 

FILEI, error in reading file 
filespec 

Error: The indexer encountered an error while reading the specified file. 
This message is usually accompanied by a VAX RMS message indicating 
the reason for the failure. 

User Action: Take corrective action based on the associated message. 

FILEO, error in writing file 
filespec 

Error: The indexer encountered an error while writing to the specified 
file. This message is usually accompanied by a VAX RMS message 
indicating the reason for the failure. 

User Action: Take corrective action based on the associated message. 
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FOLIOTOOLONG, warning: folio string too long, ignoring, inx tag is 
string 

Warning: The indexer has attempted to generate a folio string that 
exceeds the length of its internal folio buffer. It will ignore the INX tag 
that caused this. 

User Action: Contact Digital. 

IDENT, string 

Informational: Indicates the version of the INDEX utility. This message 
is produced by specifying the /IDENTIFICATION qualifier. 

User Action: None. 

ICNOREDUPREF, ignoring duplicate reference in tag 
string 

Warning: The indexer has encountered a duplicate entry tag on the same 
page and will ignore it. 

User Action: Edit the SDML file and remove the duplicate entry. 

ICNOREINPCRNC, page number references encountered in between page- 
range begin and end for entry 
string, ignoring. 

Warning: The indexer has encountered one or more single page number 
references in between a begin-end page-range sequence. It will ignore 
these in between references. 

User Action: Edit the SDML file and remove references in between the 
begin-end sequence. 

ICNOREINX_LISTLINE, ignoring INX.LIST file line. 

Warning: The above INX_LIST file line will be ignored. 

User Action: Edit the INX_LIST file and correct the erroneous line. 

INX_LIST, error on line string I filespec of string 

Warning: An error was detected in the specified line of the named 
INX_LIST file. 

User Action: Edit the INX_LIST file and correct the erroneous line. 

IN_CLOSE, Error in closing input file filespec 

Warning: 

User Action: 

LANCTRUNC, Warning: tag argument too long.<\ >argument truncated to 
string. 

Warning: The indexer has encountered a <LANGUAGE> tag argument that 
is too long, and is truncating it to the specified string. 

User Action: Edit the SDML file and shorten the <LANGUAGE> tag 
argument. 
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LANGJGNORED, The <LANGUAGE> tag is not at the beginning of the file and 
will be ignored. 

Warning: The <LANGUAGE> tag was encountered in the INX file after the 
first index entry and will be ignored. 

User Action: Reposition the <language> tag to the start of the INX file. 

LANG_NAME, unsupported language name in tag 
string ! string, ignoring, using string 

Warning: The language specified is not supported. 

User Action: Modify the <LANGUAGE> tag in the INX file to specify Danish 
English, Finnish, French, German, Italian, Norwegian, Portuguese, 
Spanish, Swedish, or some other supported language. NCS must have 
support for the specified language. 

MASTERBOTH, warning: master and BOTH on same entry for entry 
string 

using BOTH. 

Warning: The indexer has encountered an entry that contains both a 
MASTER and BOTH entry inclusion attribute. It will convert this entry to 
be a BOTH entry. 

User Action: Edit the SDML file and remove the NOMASTER attribute 
from the entry. 

MASTERNOMASTER, warning: master and NOMASTER on same entry for 

entry 

string 

using master. 

Warning: The indexer has encountered an entry that contains both a 
MASTER and NOMASTER entry inclusion attribute. It will convert this 
entry to be a MASTER entry. 

User Action: Edit the SDML file and remove the NOMASTER attribute 
from the entry. 

NCSCONVERT, error in NCS conversion function. 

Error: An internal NCS error has occurred in the indexer. 

User Action: Contact Digital. 

NCSGETCF, error in getting NCS conversion function id. 

Error: An internal NCS error has occurred in the indexer. 

User Action: Contact Digital. 

NOCLOSEQUOTE, no closing quote. 

Warning: The above INX_LIST file line is missing a closing quote. 

User Action: Edit the INX_LIST file and correct the erroneous line. 
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NOFNAMES, no filenames were found in 
filespec 

Error: The above INX_LIST file contains no filenames. 

User Action: Edit the INX_LIST file and insert one or more filenames. 

NOITEMLIST, index command line information not found on item list 

Error: The indexer could not find the command line information on its 
internal item list. 

User Action: Contact Digital. 

NOMASTERBOTH, warning: NOMASTER and BOTH on same entry for 
entry 
string 

using BOTH. 

Warning: The indexer has encountered an entry that contains both a 
NOMASTER and BOTH entry inclusion attribute. It will convert this 
entry to be a BOTH entry. 

User Action: Edit the SDML file and remove the NOMASTER attribute 
from the entry. 

NOPAGENUMARG, no argument for page number tag, ignoring. 

Warning: A page number tag is missing its argument. 

User Action: Try reprocessing to get a new INX file. If the problem 
persists, contact Digital. 

NOTAGARG, tag argument expected after tag 
stringy 

but not found. 

Error: A tag in the INX file is missing its argument. 

User Action: Try reprocessing to get a new INX file. If the problem 
persists, contact Digital. 

NULFILENAME, no file name found. 

Warning: Each non-comment non-empty line in the INX_LIST file must 
contain a file name. 

User Action: Edit the INX_LIST file and correct the erroneous line. 

OPENIN, could not open filespec for input 

Error: The input file does not exist, or you do not have access to the file. 

User Action: Check the file specification for errors and check to be sure 
that the file is not read protected. 

OPENOUT, could not open filespec for output 

Error: The output file cannot be opened. This message is usually 
accompanied by a VAX RMS message indicating the reason for the failure. 

User Action: Take corrective action based on the associated message. 
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Index Facility Messages 


OUT_CLOSE, Error in closing output file filespec 
Warning: None. 

User Action: None. 

READING, reading file filespec 

Informational: The indicated file is being read. 

User Action: None. 

SAMEPGBEGEND, warning; a begin-end page-range on same page for entry 
string 

converting to a single page-number ent ry. 

Warning: The indexer has encountered a begin page-range entry and an 
end page-range entry that fall on the same page. It will convert the begin 
page-range entry to a single page entry and ignore the end page-range 
entry. 

User Action: Edit the SDML file and remove the offending end page- 
range entry. 

TAGARGTOOLONG, indexer tag argument internal buffer limit 
exceeded for tag 
string. 

Warning: This is an indexer internal error. The buffer limit is exceeded 
for reading a tag argument. 

User Action: Edit the SDML file and shorten the lengthy tag argument. 

TAGSTRTOOLONG, indexer tag string internal buffer limit exceeded for tag 
string. 

Error: This is an indexer internal error. The buffer limit is exceeded for 
reading a tag. The INX file may be corrupted. 

User Action: Try reprocessing to get a new INX file. If the problem 
persists, contact Digital. 

TOODEEP, maximum subindex depth exceeded 

Warning: An index entry containing ten or more levels of subindexing 
was detected. The subindexing was ignored. 

User Action: Generate index entries with fewer levels of subindexing. 

TOOMANYFNAMES, too many filenames were found in 

filespec 

One or more will be lost. 

Error: The above INX_LIST file contains too many filenames for master 
index generation. The maximum number of INX filenames is 500. 

User Action: Edit the INX_LIST file and reduce the number of filenames 
to 500 or fewer, or split the file and run two separate jobs. 
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Index Facility Messages 


UNEINOWNEQSTR, unknown string precedes "=" in tag argument 
attribute list in tag string, 
attempting to continue. 

Warning: The tag argument attribute list in the INX file contains an 
unknown option string preceding the Execution will attempt to 
continue. 

User Action: Try reprocessing to get a new INX file. If the problem 
persists, contact Digital. 

UNKNOWNKWD, unknown keyword in tag arg attribute list in tag 
string,<\ >attempting to continue. 

Warning: The tag argument attribute hst in the INX file contains an 
unknown ke 5 rword. Execution will attempt to continue. 

User Action: Try reprocessing to get a new INX file. If the problem 
persists, contact Digital. 

USEFILEBOOKNAME, using file name string 

to form book name. 

Warning: The above INX_LIST file line will use the file name as the book 
name. 

User Action: Edit the INX_LIST file and correct the erroneous line. 

VMOVRFLOW, insufficient virtual memory 

Error: The indexer does not have sufficient virtual memory to generate 
the index. 

User Action: Either reduce the size of the index or increase the page file 
quota parameter (PGFLQUO) and reprocess your file. 

WRITING, writing file filespec 

Informational: The indicated file is being written to. 

User Action: None. 
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A 


<ABSTRACT> • 1-2 

description of • 1-2 
related tags 

<FRONT_MATTER> 

<PART_PAGE> 

<T1TLE_PAGE> 

<ACCENT>» 1-3 

description of • 1-3 
related tags 

<MCS> 

<PARENDCHAR> 

using acute, grave, or umlaut* 1-3 
Acute accents • 1-3 
Aligning 

numbers in a table • 1-8 

numbers in text, a list, or a table • 1-5 

text in a list* 1-4 

text on the right-hand margin of a page * 1-218 
Aligning text on the page * A-6 

<ALIGN_AFTER> * 1-4 
description of * 1 -4 
related tags 

<ALIGN_CHAR> 

<ALIGN_NUMBER> 

<UNE>(INDENT) 

<LIST>(STACKED) 

<ALIGN_CHAR> * 1-5 

description of * 1-5 to 1-7 
related tags 

<ALIGN_AFTER> 

<ALIGN_NUMBER> 

<TABLE_ROW> 

<ALIGN_NUMBER> * 1—8 

description of * 1-8 to 1-9 
related tags 

<ALIGN_CHAR> 

<ALIGN_NUMBER> 

<TABLE_ROW> 

AMPERSAND 

in math expressions * 1-166 


<AMPERSAND> * 1-10 

description of * 1-10 
related tags 

<BACKSUSH> 

<CPAREN> 

<OPAREN> 

<VBAR> 

Appendix 

changing default appendix letter* 1-224 

<APPENDIX> *1—11 

description of * 1-11 to 1-12 
related tags 

<ENDAPPENDIX> 

<SET_APPENDIX_LETTER> 

<ATOP> 

in math expressions * 1-166 
Attributes 

of examples* i-71 
of figures * 1-87 
of tables * 1-242 


B 


<BACKSLASH> * 1—1 3 
description of * 1-13 
in math expressions* 1-166 
related tags 

<AMPERSAND> 

<CPAREN> 

<OPAREN> 

<VBAR> 

BAR_CHAR 

in math expressions • 1-165 
Batch processing of files * A-4 
/BATCH qualifier * A-4 
Bold type 
in text* 1-60 

of a keyword in text* 1-139 
Bookbuilding 

creating a profile * 1-207 
creating elements * 1-56 
generating an index* 1-133, A-9 
generating a table of contents * 1-34, A-5 


Index-1 


Index 


<BOX> *1-14 

description of • 1-14 
Breaking a page *1-197 

within a monospaced example • 1-282 
Breaks 

in columns, lines, or pages • 1-98 


c 


<CAL> 

in math expressions *1-166 
Calligraphic letters * 1-166 

<CALLOUT>* 1-15 

description of * 1-15 
related tags 
<callouts> 

<CALLOUT_REF> 

<CO> 

<LIST>(CALLOUT) 

Callout numbers 

labelling in an example* 1-15, 1-17, 1-24 
labelling in text* 1-16 

<CALLOUTS> * 1-17 

description of * 1-17 to 1-18 
related tags 

<CALLOUT> 

<CALLOUT_REF> 

<C0> 

<LIST>(CALLOUT) 

<CALLOUT_REF> * 1-1 6 
description of * 1-16 
related tags 

<CALL0UT> 

<CALLOUTS> 

<CO> 

Capital letters 

small point size* 1-60 
See also <uppercase> 

Captions 

in examples* 1-71 
in figures * 1-87 
in tables * 1-242 
<cases> 

in math expressions *1-166 
Caution 

labelling text as * 1-192 

<CDOTS> 

in math expressions * 1-166 


Centering a heading * 1-22 

<CENTER_LINE> *1-19 

description of * 1-19 to 1-20 
related tags 

<LINE> 

<RIGHT_UNE> 

Change bars* 1-215 

<CHAPTER> *1-21 

description of * 1-21 
related tags 

<REFERENCE> 

<SET_CHAPTER_NUMBER> 

Chapters 

changing the default chapter number* 1-225 
<chead>*1-22 

description of * 1-22 
related tags 

<CENTER_LINE> 

<HEAD> 

<HEADn> 

<SUBHEADn> 

<CHECK_FORJNCLUSION> * 1-23 
description of * 1-23 

<CHOOSE> 

in math expressions * 1-166 
<co> * 1-24 

description of * 1-24 
related tags 

<CALLOUT> 

<CALLOUTS> 

<CALLOUT_REF> 

<LIST>{CALLOUT) 

<CODE_EXAMPLE> * 1-25 

description of * 1-25 to 1-28 
related tags 

<INTERACTIVE> 

<VALID_BREAK> 

Column breaks * 1-98 
Commands 

coding command/parameter pairs* 1-78, 1-108 
summary of * A-1 
<COMMENT> * 1-29 

description of * 1-29 to 1-30 
related tag 

<ENDCOMMENT> 

<CONDITION>* 1-31 

description of *1-31 to 1-33 
related tags 

<ENDCONDITON> 
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<CONDITION> 

related tags (cont’d) 

<SET_CONDITION> 

/CONDITION qualifier‘A-S 
Conditions 
for files • A-5 

/CONTENTS qualifier* A-5 

<CONTENTS_FILE> • 1-34 

description of • 1-34 to 1-35 
related tags 

<FRONT_MATTER> 


<DEFINE_SYMBOL> • 1-44 

description of* 1-44 to 1-45 
related tags 


<DEFINE_BOOK_NAME> 

<DELAYED> 

<REFERENCE> 
<DEFINIT10N_LIST> * 1-46 

description of * 1-46 to 1-47 
related tags 

<DEFINITION_LIST_HEAD> 


<PROFILE> 

<COPYRIGHT_DATE> • 1-36 

description of * 1-36 
related tags 


<COPYRIGHT_PAGE> 
<FRONT_MATTER> 
<COPYRIGHT_PAGE> * 1-37 
description of * 1-37 
related tags 


<COPYRlGHT_DATE> 

<ENDCOPYRIGHT_PAGE> 


<FRONT_MATTER> 

<PRINT_DATE> 

<CP> * 1-38 

description of * 1-38 
related tag 

<p> 

<CPAREN> * 1-39 

description of * 1-39 
related tags 


<DEFLIST_DEF> 
<DEFLISTJTEM> 
<ENDDEFINITION_LIST> 
<DEF1NIT10N_LIST_HEAD> * 1-48 

description of * 1-48 
related tags 


<DEFINmON_LIST> 
<DEFLIST_DEF> 
<DEFLISTJTEM> 
<DEFLIST_DEF> * 1-49 
description of * 1-49 
related tags 


<DEFINITION_LIST> 
<DEFINITION_LIST_HEAD> 
<DEFUSTJTEM> 
<DEFLISTJTEM> * 1-50 

description of * 1-50 
related tags 


<DEFINITION_LIST> 

<DEFINITION_LIST_HEAD> 


<AMPERSAND> 

<BACKSLASH> 

<OPAREN> 

<VBAR> 


D 


<DATE>*1—40 

description of * 1-40 to 1-41 

<DDOTS> 

in math expressions* 1-166 

<DEFINE_BOOK_NAME> * 1-42 

description of * 1-42 to 1-43 
related tags 

<DEFINE_SYMBOL> 

<REFERENCE> 


<DEFLIST_DEF> 

Degree character * 1-186 
<DELAYED> * 1-51 

description of *1-51 to 1-52 
related tags 

<DEFINE_BOOK_NAME> 

<DEF1NE_SYMB0L> 

<ENDDELAYED> 

Destination 

See DOCUMENT command, destination 
parameter 

/DEVICE_CONVERTER qualifier * A-6 
Diagnostics 
for LSE*A-8 

/DIAGNOSTICS qualifier * A-8 
Dialog 

between system and user* 1-135 
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<DIVIDED_BY> 

in math expressions •1-166 
Dividing a document into parts* 1-200, 1-202 
Doctype 

on the command line 

See DOCUMENT command, doctype 
parameter 
<DOCTYPE> • 1-53 

description of • 1-53 
Document 
partial 

printing • A-7 to A-8 
DOCUMENT command 
for the symbol generator 
parameters • A-17 
parameters • A-2 to A-4 
destination • A-3 
doctype • A-3 
input-file • A-2 
qualifiers • A-4 to A-16 
/BATCH •A-4 
/CONDITION •A-5 
/CONTENTS • A-5 
/DEVICE_CONVERTER • A-6 
/DIAGNOSTICS* A-8 
/ELEMENT* A-8 
/INCLUDE* A-8 
/INDEX-A-g 
/KEEP* A-10 
/LIST* A-11 
/LOG* A-11 
/MAP* A-12 
/MASTERJNDEX*A-12 
/OUTPUT* A-12 
/PRINT* A-13 
/PROFILE* A-14 
/SYMBOLS* A-15 
/TAG_TRANSLATOR * A-15 
/TEXT_FORMATTER * A-15 
summary of * A-1 to A-16 
syntax of * A-2 

DOCUMENT symbol generator * A-17 
DOCUMENT symbol generator command 
parameters 

input-file * A-17 
qualifiers * A-17 
/LIST* A-18 
/PREFIX* A-18 


Document type 

on the command line 

See DOCUMENT command, doctype 
parameter 

<DOTS> 

in math expressions * 1-166 
dot_char 

in math expressions* 1-165 

<DOT_TIMES> 

in math expressions * 1-166 
<DOUBLE_QUOTE> * 1-54 

description of • 1-54 to 1-55 
related tags 

<PARENDCHAR> 

<QUOTE> 

<SINGLE_QUOTE> 

Duplex printing * A-6 


E 


<ELEMENT> * 1-56 

description of * 1-56 to 1-57 
related tags 

<INCLUDES_FILE> 

<PROFILE> 

/ELEMENT qualifier * A-8 
<ELLIPSIS> * 1-58 

description of * 1-58 to 1-59 
related tag 

<HELLIPSIS> 

Embedded tables 

breaking across pages* 1-189 
<EMPHAS1S> * 1 -60 

description of* 1-60 to 1-61 
related tags 

<QUOTE> 

<UNDERLINE> 

Emphasizing 

a keyword in text * 1-139 
a new term in text* 1-191 
a variable in text* 1-285 

<ENDABSTRACT> * 1-2 
<ENDALIGN_CHAR> *1-5 
<ENDAPPENDIX> *1-11 
<ENDCALLOUTS> *1-17 
<ENDCHECK_FORJNCLUSION> * 1-23 
<ENDCODE_EXAMPLE> * 1-25 
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<ENDCOMMENT> • 1 -29 
<ENDC0NDIT10N> *1-31 
<ENDCOPYRIGHT_PAGE>» 1-37, 1-62 
description of • 1-62 

<ENDDEFINITI0N_L1ST> • 1-46 
<ENDDELAYED> *1-51 
<ENDEXAMPLE> • 1-66 
<ENDFIGURE> • 1-81 
<ENDFORMAT> *1-108 
<ENDFRONT_MATTER> *1-111 
<ENDGLOSSARY> *1-114 
<ENDICON> * 1-124 
<ENDINTERACTIVE> *1-135 
<ENDLINE_ART> * 1-1 47 
<ENDLIST> *1-150 
<ENDLITERAL> * 1-157 
<ENDMARK> * 1-160 
<ENDMATH>* 1-163 
<ENDNOTE>* 1-192 
<ENDPART_PAGE> * 1-63, 1-202 
description of * 1-63 
<ENDPREFACE> * 1-203 
<ENDPROFILE> * 1-207 
<ENDSAMPLE_TEXT> * 1-223 
<ENDTABLE>* 1-240 
<ENDTABLE_KEY> * 1-250 
<ENDT1TLE_PAGE> * 1-64, 1-269 
description of * 1-64 

<ENDUNDERLINE> * 1—272 
<ENDUPDATE_RANGE> * 1-274 
<EQUALIGN> 

in math expressions * 1-166 

<EQUALS> 

in math expressions * 1-166 
Equations in math * 1-163 
Error messages * B-1 
<EXAMPLE> * 1-65 

description of * 1-65 to 1-70 
related tags 

<CODE_EXAMPLE> 

<ENDEXAMPLE> 

<ENDINTERACTIVE> 

<EXAMPLE_ATTRIBUTES> 

<EXAMPLE_FILE> 

<EXAMPLE_SPACE> 

<INTERACT1VE> 

<REFERENCE> 


<EXAMPLE> 

related tags (cont’d) 

<VALID_BREAK> 

Examples 
formal * 1-65 
informal * 1-25 

using callouts in * 1-15, 1-17, 1-24 

<EXAMPLE_ATTRIBUTES> * 1-71 

description of* 1-71 to 1-74 
related tags 

<EXAMPLE> 

<EXAMPLE_FILE> 

<EXAMPLE_SPACE> 

<REFERENCE> 

<EXAMPLE_FILE> * 1-75 
description of* 1-75 
related tags 

<EXAMPLE> 

<EXAMPLE_ATTRIBUTES> 

<EXAMPLE SPACE> 


<REFERENCE> 
<EXAMPLE_SPACE> * 1-76 

description of* 1-76 to 1-77 
related tags 

<EXAMPLE> 

<EXAMPLE_ATTRIBUTES> 

<EXAMPLE_FILE> 

<REFERENCE> 


F 


<FCMD> * 1-78 

description of * 1-78 to 1-80 
related tags 

<FORMAT> 

<FPARM> 

<FPARMS> 

<FIGURE> * 1-81 

description of * 1-81 to 1-86 
related tags 

<ENDFIGURE> 

<FlGURE_ATrRlBUTES> 

<FIGURE_FILE> 

<FIGURE_SPACE> 


<S> 


<1C0N> 


<SAMPLE_TEXT> <ICON_FILE> 

<U> <LINE_ART> 
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<FIGURE> 

related tags (cont’d) 

<REFERENCE> 

Figures 

captions of* 1-87 

changing the default for vertical blank space • 
1-228 

coding multipage figures* 1-87 
coding wide figures * 1-87 
controlling attributes of * 1-87 
controlling formality of* 1-87 
creating * 1-89 
creating line art 

See <LiNE_ART> 

keeping a figure with its preceding text * 1-87 
leaving space for * 1-93 
margins in * 1-87 
numbers in the caption * 1-87 
page breaks in * 1-87 
width of * 1-87 
<FIGURE_ATTRIBUTES> * 1-87 

description of * 1-87 to 1-88 
related tags 

<FIGURE> 

<FIGURE_F1LE> 

<FIGURE_SPACE> 

<FIGURE_FILE> * 1-89 

description of* 1-91 to 1-92 
related tags 

<FIGURE> 

<FIGURE_ATTRIBUTES> 

<ICON> 

<ICON_FILE> 

<LINE_ART> 

<REFERENCE> 

<SET_FIGURE_FILE_SPACING_DEFAULT> 
<FIGURE_SPACE> * 1 -93 

description of * 1-93 to 1-95 
related tags 

<FIGURE> 

<FIGURE_ATTRIBUTES> 

<LINE_ART> 

<REFERENCE> 

Files 

bookbuilding with elements * 1-56 
intermediate 

keeping during processing * A-10 
listing 

producing during processing * A-11 
producing for the symbol generator * A-18 


Files (cont’d) 
log 

producing during processing * A-11 
page parameters 
changing * A-6 

printing after processing * A-13 
processing 

assigning new output name * A-12 
processing in batch mode * A-4 
producing map files during processing • A-12 
setting conditions* 1-31, 1-226, A-5 
File specifications 

in tag arguments * 1-96 
<FILE_SPEC> * 1-96 

description of* 1-96 to 1-97 
related tags 

<ELEMENT> 

<EXAMPLE_FILE> 

<FIGURE_FILE> 

<ICON_FILE> 

<INCLUDE> 

<INCLUDES_FILE> 

<TABLE_FILE> 

<FINAL_CLEANUP> * 1-98 

description of* 1-99 to 1-100 
related tags 

<coLUMN>, in ARTICLE and REPORT.TWOCOL 
doctypes 

<LINE> 

<PAGE> 

<FOOTNOTE> * 1-101 

description of* 1-101 to 1-103 
related tags 

<FOOTNOTE_TEXT> 

<FOOTREF> 

<FOOTNOTE_TEXT> *1-104 

description of* 1-104 to 1-105 
related tags 

<FOOTNOTE> 

<FOOTREF> 

<FOOTREF> * 1-106 

description of * 1-106 to 1-107 
related tags 

<FOOTNOTE> 

<FOOTNOTE_TEXT> 

Formal examples * 1-65 
<FORMAT> * 1—108 

description of * 1-108 
related tags 
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<FORMAT> 

related tags (cont’d) 

<FCMD> 

<FPARM> 

<FPARMS> 

Formatting 

for special results • 1-98 
<FPARM>* 1-109 

description of • 1-109 
related tags 

<FCMD> 

<FORMAT> 

<FPARMS> 

<FPARMS> *1-110 

description of • 1-110 
related tags 

<FCMD> 

<FORMAT> 

<FPARM> 

<FR0NT_MATTER> *1-111 

description of *1-111 to 1-112 
related tags 

<ABSTRACT> 

<CONTENTS_FILE> 

<COPYRIGHT_DATE> 

<C0PYR1GHT_PAGE> 

<DEFINE_BOOK_NAME> 

<ENDFRONT_MATTER> 

<ORDER_NUMBER> 

<PREFACE> 

<PREFACE_SECTION> 

<PRINT_DATE> 

<REVISION_INFO> 

<TITLE> 

<TITLE_PAGE> 

<FUNC> 

in math expressions* 1-166 



<GDEF> * 1-113 

description of * 1-113 
related tags 

<GLOSSARY> 

<GREF> 

<TERM> 

Generating symbols * A-17 


<GLOSSARY> * 1-114 

description of * 1-114 to 1-115 
related tags 

<ENDGLOSSARY> 

<GDEF> 

<GTERM> 

Glossary entries 

creating a cross-reference to a term * 1-116 
creating entries anywhere in your document • 
1-117 

creating entries in your document* 1-113 
Graphics files 

including in SDML files * 1-81, 1-124 
Grave accents * 1-3 

<GREF> * 1-116 

description of * 1-116 
related tags 

<GDEF> 

<GLOSSARY> 

<GTERM> 

<GROUP> 

in math expressions * 1-166 

<GTERM> * 1-117 

description of * 1-117 
related tags 

<GDEF> 

<GLOSSARY> 

<GREF> 


H 


hat 

in math expressions * 1-165 
hat_char 

in math expressions * 1-165 

<HEAD> * 1-118 

description of * 1-118 
related tags 

<CENTER_LINE> *1-118 
<CHEAD> * 1-118 
<HEADn>* 1-118 
<SUBHEADn> * 1-118 

Headings 

centered on a line * 1-22 
<HEADn> * 1—119 

description of * 1-119 to 1-121 
related tags 

<CHEAD> 
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<HEADn> 

related tags (cont’d) 

<HEAD> 

<SUBHEADn> 

<HELLIPSIS>« 1-122 

description of • 1-122 
related tag 

<ELLIPSIS> 

<HYPHENATE> *1-123 
description of • 1-123 
related tags 

<FINAL_CLEANUP>(L1NE_BREAK) 

<KEEP> 

<LINE> 

Hyphenation 

for specific line breaks *1-123 


I 


<icon>*1-124 

description of • 1-124 to 1-126 
related tags 

<ENDICON> 

<FIGURE_FILE> 

<ICON_FILE> 

<ICON_TEXT> 

<ICON_FILE>* 1-127 

description of • 1-127 to 1-128 
related tags 

<FIGURE_FILE> 

<ICON> 

<1C0N_TEXT> 

<ICON_TEXT> *1-129 

description of * 1-129 
related tags 

<ICON> 

<ICON_FILE> 

Identification number at the bottom of a copyright 
page*1-62 
<INCLUDE> * 1-130 

description of * 1-130 
/INCLUDE qualifier * A-8 
<INCLUDES_FILE> * 1-1 31 

description of * 1-131 to 1-132 
related tags 

<ELEMENT> 

<INCLUDE> 

<PROFILE> 


Including a file in the current input file * 1-130 

Indenting a line * 1-144 

Index 

effect on the index when using a <revision> tag in a 
file *1-215 

generating * 1-133, A-9 
Indexing 

creating main entries * 1-287 
creating “See” and “See also” entries * 1-298 
creating subentries * 1-294, 1-296 
using <xappend> in the <x> tag * 1-287 
using <xsort> in the <x> tag * 1-288 
using <xsort> in the <y> tag * 1-298 
/INDEX qualifier * A-9 

<INDEX_FILE> * 1—133 

description of* 1-133 to 1-134 
related tags 

<CONTENTS_FILE> 

<PR0F1LE> 

Informal examples* 1-25 
Informational messages 

sending to a terminal or a log file * 1-278 
Input file 

See SDML file 

<INTEGRAL> 

in math expressions* 1-167 

<INTEGRAL_LIMITS> 

in math expressions * 1-167 

<INTEGRAL_NOLIMITS> 

in math expressions* 1-167 

<1NTERACTIVE> *1-135 

description of* 1-135 to 1-137 
related tags 

<ENDINTERACTIVE> 

<S> 

<u> 

<VALID_BREAK> 

Intermediate files 

keeping during processing *A-10 
Italicizing 

a keyword in text * 1-139 
a new term in text* 1-191 
a variable in text * 1-285 
Italics 

in text* 1-60 
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K 


<KEEP> *1-138 

description of • 1-138 
related tags 

<DEFINE_SYMBOL> 

<EMPHASIS> 

<HYPHENATE> 

/KEEP qualifier* A-10 
<KEYWORD> *1—139 

description of * 1 -139 
related tags 

<NEWTERM> 

<SPECIAL_CHAR> 

<VARIABLE> 


L 


Labelling parts of your document* 1-200, 1-202 
<LANGUAGE> * 1-140 

description of* 1-140 to 1-142 

<LBAR> 

in math expressions * 1-167 

<LBRACE> 

in math expressions* 1-167 

<LBRACKET> 

in math expressions * 1-167 

<LCEIL> 

in math expressions * 1-167 
<LE>* 1-143 

description of * 1 -143 
related tag 

<LIST> 

<LFLOOR> 

in math expressions * 1-167 
<LINE> * 1-144 

description of * 1-144 to 1-146 
related tags 

<CENTER_LINE> 

<FINAL_CLEANUP> 

<RIGHT_LINE> 

Line breaks * 1-98 

<LINE_ART> * 1-147 

description of* 1-147 to 1-148 


<LINE_ART> (cont’d) 

related tags 

<ENDLINE_ART> 

<FIGURE> 

<VALID_BREAK> 

<LIST> * 1-149 

description of * 1-149 to 1-156 
related tags 

<ALIGN_AFTER> 

<AUGN_CHAR> 

<ENDLIST> 

<LE> 

Listing file 

producing during processing * A-11 
producing for the symbol generator * A-18 
/LIST qualifier * A-11 

for the symbol generator * A-18 
<LITERAL>* 1-157 

description of* 1-157 to 1-158 
related tag 

<ENDLITERAL> 

Log files 

producing during processing * A-11 
/LOG qualifier * A-11 
<LOWERCASE> *1-159 
description of* 1-159 
related tag 

<UPPERCASE> 

<LPAREM> 

in math expressions * 1-167 
LSE 

running diagnostics * A-8 




Map files 

producing during processing * A-12 
/MAP qualifier* A-12 
Margins 

in figures * 1-87 
<MARK> *1-160 

description of* 1-160 to 1-162 
related tags 

<ENDMARK> 

<REVISION> 

<UPDATE_RANGE> 

Marking text 

using change bars * 1-215 
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/MASTERJNDEX qualifier • A-12 
<MATH> • 1-163 

description of • 1-163 to 1-177 
related tags 

<CODE_EXAMPLE> 

<ENDMATH> 

<MATH_CHAR> 

<REFERENCE> 

tags for math expressions 

<ATOP> 

<BACKSLASH> 

<BAR_CHAR> 

<CAL> 

<CASES> 

<CDOTS> 

<CHOOSE> 

<DDOTS> 

<DIVIDED_BY> 

<DOTS> 

<DOT_CHAR> 

<DOT_TIMES> 

<EQUALIGN> 

<EQUALS> 

<FUNC> 

<GROUP> 

<HAT> 

<HAT_CHAR> 

<INTEGRAL> 

<INTEGRAL_LIMITS> 

<INTEGRAL_NOLIMITS> 

<LBAR> 

<LBRACE> 

<LBRACKET> 

<LCEIL> 

<LFLOOR> 

<LPAREN> 

<MATRIX> 

<MINUS> 

<MOD> 

<OVER> 

<OVERLINE> 

<PI> 

<PLUS> 

<PMOD> 

<PROD> 


<MATH> 

tags for math expressions (cont’d) 

<RBRACKET> 

<RCEIL> 

<RFLOOR> 

<RPAREN> 

<SP> 

<SQRT> 

<SUBSCRIPT> 

<SUM> 

<SUM_LIMITS> 

<SUM_NOLIMITS> 

<SUPERSCRIPT> 

<TEXT> 

<TILDE> 

<TILDE_CHAR> 

<TIMES> 

<TO> 

<UNDERLINE> 

<VARIABLE> 

<VDOTS> 

<VECTOR> 

<X_TIMES> 

Math expressions 

aligning expressions *1-172 
delimited expressions *1-173 
tags for math functions * 1-170 
tags valid in math expressions * 1-166 
using binary operations * 1-164 
using mathematical functions * 1-170 
using matrixes and cases * 1-174 
using operators with and without limits * 1-169 
using parentheses * 1-164 
using variable names * 1-165 
<MATH_CHAR> *1-178 

description of * 1-178 to 1-185 
related tags 

<MATH> 

<MCS> 

<SPECIAL_CHAR> 

<MATRIX> 

in math expressions * 1-167 
<Mcs>* 1-186 

description of * 1-186 to 1-188 
related tags 

<MATH_CHAR> 


<PROD_LIMITS> 

<PROD_NOLIMITS> 

<RBAR> 

<RBRACE> 


<SPECIAL_CHAR> 

Messages 

sending informational messages to terminal or log 
file *1-278 
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Messages (cont’d) 

sending warning messages to terminal or log file • 
1-280 

summary of • B-1 to B-101 

<MINUS> 

in math expressions* 1-167 

<M0D> 

in math expressions* 1-167 
Multinational Character Set* 1-186 


N 


Nested tables 

breaking across pages * 1-189 

<NESTED_TABLE_BREAK> * 1-189 

description of * 1-189 to 1-190 
related tags 

<TABLE> 

<TABLE_FILE> 

Nesting a tag 

in an outer tag’s argument* 1-51 
<NEWTERM>* 1-191 

description of * 1-191 
related tags 

<KEYWORD> 

<VARIABLE> 

<NOTE> * 1-1 92 

description of* 1-192 
related tag 

<ENDNOTE> 

Numbers 

aligning in a table* 1-8 

aligning in text, a list, or a table * 1-5 

in figures * 1-87 


o 


<OPAREN>* 1-193 

description of* 1-193 
related tags 

<AMPERSAND> 

<BACKSLASH> 

<CPAREN> 

<VBAR> 

<ORDER_NUMBER> * 1-194 

description of * 1-194 


<ORDER_NUMBER> (COnt’d) 

related tag 

<TITLE_PAGE> 

Output devices 

See DOCUMENT command, destination 
parameter 
Output file name 
changing * A-12 
/OUTPUT qualifier* A-12 

<OVER> 

in math expressions * 1-167 
OVERLINE 

in math expressions * 1-166 


P 


<p>* 1-195 

description of* 1-195 to 1-196 
related tags 

<CENTER_LINE> 

<CP> 

<LINE> 

<RIGHT_LINE> 

<PAGE> * 1-1 97 

description of * 1 -197 to 1-198 
related tag 

<FINAL_CLEANUP>(PAGE_BREAK) 

Page breaks * 1-197 
for final cleanup * 1-98 
in figures* 1-87 

within monospaced examples * 1-282 
Page parameters 
changing * A-6 
Paragraphs* 1-195 

continuing when interrupted * 1-38 
Parameters 

of the DOCUMENT command for the symbol 
generator* A-17 

Parameters of the DOCUMENT command 
See DOCUMENT command, parameters 

<PARENDCHAR> *1-199 

description of * 1-199 
Parentheses 

in tag arguments * 1-39, 1-193 
spacing for a character within *1-199 
using in math * 1-164 
<PART>* 1-200 

description of* 1-200to 1-201 
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<PART> (cont’d) 

related tag 

<PART_PAGE> 

Partial document 
printing * A-7 to A-8 
<PART_PAGE> • 1-202 
description of • 1-202 
related tags 

<ABSTRACT> 

<ENDPART_PAGE> 

<PART> 

<RUNNING_TITLE> 

<TITLE> 

<PI> 

in math expressions* 1-167 

<PLUS> 

in math expressions* 1-167 

<PMOD> 

in math expressions* 1-167 
<PREFACE> * 1-203 

description of* 1-203 to 1-204 
related tags 

<ENDPREFACE> 

<FRONT_MATTER> 

<PREFACE_SECTION> 
<PREFACE_SECTION> * 1-205 
description of * 1-205 
related tags 

<FRONT_MATTER> 

<PREFACE> 

/PREFIX qualifier * A-18 
Printing 

blank pages * A-6 
duplex pages * A-6 
sections of a document * A-7 to A-8 
Printing files 
double-spacing 
after processing * A-13 
/PRINT qualifier * A-13 
<PRINT_DATE> * 1-206 
description of * 1-206 
related tags 

<COPYRIGHT_PAGE> 

<FRONT_MATTER> 

Processing files 

assigning a new output name * A-12 
batch mode * A-4 
checking files for inclusion * 1-23 
generating a table of contents * 1-34 


Processing files (cont’d) 
index * A-9 
indexing * 1-133 
intermediate files 
keeping* A-10 
listing file 

producing * A-11 

producing for the symbol generator * A-18 
log file 

producing * A-11 
map file 

producing * A-12 
page parameters 
changing * A-6 
printing 

double-spacing * A-13 
setting conditions * 1-31, 1-226 
setting conditions for * A-5 
table of contents * A-5 
using elements for bookbuilding * 1-56 

<PROD> 

in math expressions * 1-167 

<PROD_LIMITS> 

in math expressions * 1-168 

<PROD_NOLIMITS> 

in math expressions * 1-168 
Profile 

generating an index * A-9 
generating an index from * 1-133 
generating a table of contents * A-5 
generating a table of contents from * 1-34 
<PROFILE> * 1-207 

description of* 1-207 to 1-208 
related tags 

<ELEMENT> 

<ENDPROFILE> 

<1NCLUDES_FILE> 

/PROFILE qualifier* A-14 



Qualifiers 

See DOCUMENT command, qualifiers 
See DOCUMENT symbol generator command, 
qualifiers 
<QUOTE>* 1-209 

description of* 1-209 to 1-210 
related tags 

<DOUBLE_QUOTE> 
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<QUOTE> 

related tags (cont’d) 

<SINGLE_QUOTE> 


s 


R 


<RBAR> 

in math expressions *1-168 

<RBRACE> 

in math expressions *1-168 

<RBRACKET> 

in math expressions* 1-168 

<RCE1L> 

in math expressions* 1-168 

<REFERENCE>* 1-211 

description of* 1-211 to 1-214 
Renumbering after a part page • 1-63 
Revising pages * 1-274 
Revising text 

using change bars * 1-215 

<REVISION>* 1-215 

description of * 1-215 to 1-216 
related tags 

<MARK> 

<UPDATE_RANGE> 

<REVISIONJNFO> * 1-217 

description of * 1-217 
related tags 

<FRONT_MATTER> 

<TITLE_PAGE> 

<RFLOOR> 

in math expressions* 1-168 
Right-justified text * 1-218 

<RIGHT_LINE>* 1-218 

description of * 1-218 to 1-219 
related tags 

<CENTER_UNE> 

<LINE> 

<RPAREN> 

in math expressions * 1-168 
<RULE> * 1-220 

description of* 1-220 
related tags 

<SPAN> 

<TABLE> 

<TABLE_HEADS> 

<TABLE_ROW> 

<TABLE_UNIT_HEADS> 


<S>* 1-221 

description of* 1-221 to 1-222 
related tags 

<EXAMPLE> 

<INTERACTIVE> 

<U> 

<SAMPLE_TEXT> * 1-223 
description of* 1-223 
related tags 

<CENTER_LINE> 

<ENDSAMPLE_TEXT> 

<P> 

Scientific characters * 1-178 
SDML file 

specifying to DOCUMENT command 

See DOCUMENT command, input-file 
parameter 

specifying to DOCUMENT symbol generator 
command 

See DOCUMENT symbol generator 
command, input-file parameter 
Sections of a document 
printing * A-7 to A-8 

<SET_APPENDIX_LETTER> * 1-224 

description of * 1-224 
related tags 

<APPENDIX> 

<sET_APPENDix_NUMBER> In the MILSPEC doctype 
<SET_CHAPTER_NUMBER> 

<SET_CHAPTER_NUMBER> • 1-225 
description of • 1-225 
related tags 

<CHAPTER> 

<SET_APPENDIX_LETTER> 

<SET_CONDITION> * 1-226 

description of * 1-226 to 1-227 
related tag 

<CONDmON> 

<SET_FIGURE_FILE_SPACING_DEFAULT> * 1-228 

description of * 1-228 to 1-229 
related tags 

<FIGURE> 

<FIGURE_F1LE> 

<SET_TABLE_ROW_BREAK_DEFAULT> * 1-230 

description of * 1-230 to 1-231 
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<SET_TABLE_ROW_BREAK_DEFAULT> (COnt’d) 

related tag 

<TABLE_ROW_BREAK> 

<SINGLE_QUOTE> • 1-232 
description of • 1-232 
related tags 

<DOUBLE_QUOTE> 

<PARENDCHAR> 

<QUOTE> 

<SP> 

in math expressions* 1-168 
Spacing within parentheses *1-199 
<SPAN> * 1-233 

description of * 1-233 to 1-235 
related tags 

<RULE> 

<TABLE_HEADS> 

<TABLE_UNIT_HEADS> 

Special formatting * 1-98 
<SPECIAL_CHAR> * 1-236 

description of * 1-236 to 1-237 
related tags 

<MATH_CHAR> 

<MCS> 

<SQRT> 

in math expressions * 1-168 
<SUBHEADn> * 1-238 

description of * 1-238 
related tags 

<CHEAD> 

<HEADn> 

<SUBSCRIPT> 

in math expressions * 1-168 

<SUM> 

in math expressions * 1-168 
Summary of commands * A-1 

<SUM_LIMITS> 

in math expressions * 1-168 

<SUM_NOLIMITS> 

in math expressions * 1-168 

<SUPERSCRIPT> 

in math expressions * 1-169 
Symbol definitions file * 1-44 
Symbol definitions file for books * 1-42 
Symbol generator command 
parameters * A-17 
Symbol names 

default output* 1-211 
referring to in other files * 1-44 


Symbol names for books 

referring to in other files * 1-42 
Symbols 

generating by the symbol generator • A-17 
/SYMBOLS qualifier * A-15 
Syntax 

See DOCUMENT command, syntax of 
System/user dialog *1-135 


T 


<TABLE> * 1-239 

description of * 1-239 to 1-241 
related tags 

<ALIGN_CHAR> 

<ALIGN_NUMBER> 

<ENDTABLE> 

<NESTED_TABLE_BREAK> 

<REFERENCE> 

<RULE> 

<SPAN> 

<TABLE_ATTRIBUTES> 

<TABLE_FILE> 

<TABLE_HEADS> 

<TABLE_KEY> 

<TABLE_KEYREF> 

<TABLE_ROW> 

<TABLE_ROW_BREAK> 

<TABLE_SETUP> 

<TABLE_SPACE> 

<TABLE_UNIT> 

<TABLE_UNIT_HEADS> 

<VALID_TABLE_ROW_BREAK> 

Table of contents 

effect on the table of contents when using a 
<REvisioN> tag in a file * 1-215 
generating * 1-34, A-5 
Tables 

attributes of * 1-242 
breaking a table across pages * 1-256 
breaking nested tables across pages * 1-189 
creating table headings * 1-248 
creating table rows * 1-254 
grouping table rows • 1-263 
headings for table units * 1-265 
including a separate table file in an SDML file * 
1-246 

leaving space for a table in a document * 1-261 
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Tables (cont’d) 

outputting a rule following table headings • 1-220 
overriding the default page break • 1-230 
page breaks within table rows • 1-284 
setting up table columns • 1-259 
text exceeding column width • 1-233 
using a table key or legend • 1-250 

<TABLE_ATTRIBUTES> • 1-242 

description of • 1-242 to 1-245 
related tags 

<TABLE> 

<TABLE_SETUP> 

<TABLE_FILE> • 1-246 

description of • 1-246 to 1-247 
related tag 

<TABLE> 

<TABLE_HEAbS> • 1-248 

description of • 1-248 to 1-249 
related tags 

<RULE> 

<SPAN> 

<TABLE> 

<TABLE_KEY> • 1-250 

description of • 1-250 to 1-252 
related tags 

<ENDTABLE_KEY> 

<FOOTNOTE> 

<TABLE> 

<TABLE_KEYREF> 

<TABLE_SETUP> 

<TABLE_KEYREF> • 1-253 
description of • 1-253 
related tags 

<TABLE> 

<TABLE_KEY> 

<TABLE_ROW> • 1-254 

description of • 1-254 to 1-255 
related tags 

<ALIGN_CHAR> 

<ALIGN_NUMBER> 

<RULE> 

<SPAN> 

<TABLE> 

<TABLE_R0W_BREAK> 

<VALID_TABLE_ROW_BREAK> 

<Table_row^break> • 1-256 

description of • 1-256 to 1-258 
related tags 

<NESTED_TABLE_BREAK> 


<TABLE_R0W_BREAK> 

related tags (cont’d) 

<TABLE> 

<TABLE_UNIT> 

<valid_table^row_brEak> 

<TABLE_SETUP> • 1-259 

description of • 1-259 to 1-260 
related tags 

<TABLE> 

<TABLE_ATrRIBUTES> 

<TABLE_SPACE> • 1-261 

description of *1-261 to 1-262 
related tags 

<TABLE> 

<TABLE_ROW> 

<TABLE_UNIT> * 1-263 

description of * 1-263 to 1-264 
related tags 

<TABLE> 

<TABLE_ROW_BREAK> 

<TABLE_UNIT_HEADS> 

<TABLE^UNIT_HEAOS> * 1-265 

description of * 1-265 to 1-266 
related tags 

<RULE> 

<SPAN> 

<TABLE> 

<TABLE_UNIT> 

Tag 

nested in an outer tag’s argument* 1-51 
<TAG>* 1-267 

description of * 1-267 
related tag 

<LITERAL> 

/TAG_TRANSLATOR qualifier * A-15 
Text 

aligning in a list* 1-^ 

aligning on the right-hand margin of a page 
1-218 

breaking a page of * 1 -197 
centering in margin * 1-19 
coding literally * 1-157 
in double quotes * 1-54 
in lowercase * 1-159 
in quotes * 1-209 
in single quotes • 1-232 
in uppercase * 1-277 

keeping on the same line of output* 1-138 
labelling a note, c^iution, or warning • 1-192 
marking for exclusion * 1-29 
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Text (cont’d) 

placing on a new line •1-144 
special formatting of • 1-223 
underlining • 1-272 
using callouts in • 1-16 

<TEXT> 

in math expressions *1-169 
/TEXT_FORMATTER qualifier • A-15 
tilde 

in math expressions *1-166 
tilde_char 

in math expressions* 1-166 

<TIMES> 

in math expressions * 1-169 
<TITLE> * 1-268 

description of * 1-268 
related tags 

<PART_PAGE> 

<TITLE_PAGE> 

Title page 

revision information * 1-217 
text at bottom of the page * 1-64 
<TITLE_PAGE> * 1-269 
description of * 1-269 
related tags 

<ENDTITLE_PAGE> 

<FRONT_MATTER> 

<TO> 

in math expressions * 1-169 
Trademark symbol * 1-236 
in footnotes * 1-101 


u 


<u>* 1-270 

description of * 1-270 to 1-271 
related tags 

<EXAMPLE> 

<INTERACTIVE> 

<s> 

Umlaut accents * 1-3 
UNDERLINE 

in math expressions *1-166 
<UNDERL1NE> * 1—272 

description of * 1-272 to 1-273 
related tag 

<ENDUNDERLINE> 


<UPDATE_RANGE> * 1-274 

description of* 1-274td 1-276 
related tags 

<ENDUPDATE_RANGE> 

<MARK> 

<REVISION> 

Updating pages * 1-274 
Updating text 

using change bars * 1-215 
<UPPERCASE> * 1-277 
description of * 1-277 
related tag 

<LOWERCASE> 

<USERJ_MESSAGE> * 1-278 

description of * 1-278 to 1-279 
related tag 

<USER_W_MESSAGE> 
<USER_W_MESSAGE> * 1-280 

description of * 1-280 to 1-281 
related tag 

<USERJ_MESSAGE> 


V 


<VALID_BREAK> * 1-282 

description of * 1-282 to 1-283 
related tags 


<CODE_EXAMPLE> 

<DISPLAY> 

<INTERACTIVE> 

<LINE_ART> 

<VALID_TABLE_ROW_BREAK> * 1-284 

description of* 1-284 
related tags 

<NESTED_TABLE_BREAK> 


<TABLE> 

<VARIABLE>* 1-285 

description of * 1-285 
in math expressions * 1-169 
related tag 

<KEYWORD> 

VAX DOCUMENT 

See DOCUMENT command 

<VBAR> * 1—286 

description of* 1-286 
related tags 


<AMPERSAND> 
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<VBAR> 

related tags (cont’d) 

<BACKSLASH> 

<CPAREN> 

<OPAREN> 

<VDOTS> 

in math expressions *1-169 
VECTOR 

in math expressions* 1-166 

<VECTOR> 

in math expressions* 1-169 
Vertical bar 

using in an argument* 1-286 


w 


Warning 

labeiling text as * 1 -192 
Warning messages 

sending to a terminal or a log file * 1-280 
Width 

in figures * 1-87 


X 


<x>* 1-287 

description of * 1-287 to 1-293 
related tags 
<xs> 

<XSUBENTRY> 

<Y> 


<xs>* 1-294 

description of* 1-294 to 1-295 
related tags 
<x> 

<XSUBENTRY> 


<Y> 

<XSUBENTRY> * 1-296 

description of * 1-296 to 1-297 
related tags 
<x> 

<xs> 


<Y> 

<X_TIMES> 

in math expressions * 1-169 


Y 


<Y> * 1-298 

description of * 1-298 to 1-299 
related tags 
<x> 

<xs> 

<XSUBENTRY> 
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How to Order Additional Documentation 


Technical Support 

If you need help deciding which documentation best meets your needs, call 800-343-4040 before placing 
your electronic, telephone, or direct mail order. 


Electronic Orders 

To place an order at the Electronic Store, dial 800-DEC-DEMO (800-332-3366) using a 1200- or 2400-baud 
modem. If you need assistance using the Electronic Store, call 800-DIGITAL (800-344-4825). 


Telephone and Direct Mail Orders 


Call 

800-DIGITAL 

809-754-7575 
800-267-6215 

International - 

Internal^ - 


Contact 

Digital Equipment Corporation 

P.O. Box CS2008 

Nashua, New Hampshire 03061 

Local Digital subsidiary 

Digital Equipment of Canada 
Attn: DECdirect Operations KA02/2 
P.O. Box 13000 
100 Herzberg Road 
Kanata, Ontario, Canada K2K 2A6 

Local Digital subsidiary or 
approved distributor 

USASSB Order Processing - WMO/E15 
or 

U.S. Area Software Supply Business 
Digital Equipment Corporation 
Westminster, Massachusetts 01473 


Your Location 

Continental USA, 
Alaska, or Hawaii 

Puerto Rico 
Canada 


^For internal orders, you must submit an Internal Software Order Form (EN-01740-07). 
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